优先使用api或api
我已经阅读了swagger定义和格式，并了解到swagger定义用于描述API. 最好先编写swagger定义，然后再编写API?还是先写API然后大张旗鼓?我对此没有经验，我想为应用程序编写一个REST API和一个swagger文件. 解决方案 我认为顺序并不重要.Swagger 入门指南中赋予了这两种方法合法性.关键是，一个应该从另一个生成，因此您不必手动维护这两个. 在
..
swagger相关内容
Swagger @ApiModelProperty示例值null(对于Long)
我将 SpringFox 和Swagger UI用于API文档. 我有一个DTO，其中有一个类型为Long的属性.它没有99％的时间被填充，因此我想通过将属性值设置为 null 来在文档中证明这一事实.所以我想在示例部分中使用此JSON {/* ... */"legacyId":null} 我已经尝试过 @ApiModelProperty(值="legacyId"，示例= null)
..
使用Swagger码源的RX JAVA + Retrofit sdk生成
我想使用swagger codegen生成sdk，它可以为我生成带有Observable的sdk，如下所示: @POST("oauth/token") 可观察的getRepository(@Query("grant_type")字符串grantType); 解决方案 您可以使用以下命令作为示例来生成启用了RxJava的Java Retrofit API客户端: ja
..
从Swagger错误导入Amazon API Gateway-不采用泛型
我正在尝试通过从Swagger导入来创建新的APIGateway，但是出现验证错误: 引起问题的特定类是我们的PaginationModel类. 代码模型定义: 公共类PaginationModel{公共IEnumerable T项目{get;放;}public int offset {获取；放;}public int totalCount {get;放;}} 代表特定类
..
如何在整个Swagger YAML文档中重复使用我的x-amazon-apigateway-integration定义?
我目前正在使用Swagger定义具有许多端点的API，并且这些端点中的每一个都对"x-amazon-apigateway-integration"键具有相同的定义.我想在文档中的某个位置定义此名称，然后在整个过程中重复使用该定义. 要么我不理解应该如何定义定义，要么我没有将其放置在正确的位置，也没有将二者结合在一起.我尝试在“定义"中定义此定义，并在其自己的键下定义一些别名.定义(删除了关键
..
大张旗鼓地为通用控制器添加文档和操作
我正在使用带插件的webapi.添加插件后，我想更新swagger文档.当我不使用版本时，我可以处理.所有方法都添加到了swagger文档中. 但是当api开启apiversion时，新版本swagger文档的生成失败.返回404. 我是否需要做任何事情以使版本工作并获得动态控制器功能... 私有字符串AddSwaggerVersionDocument(PluginMetadata元
..
如何通过控制器名称对NSwag swagger.json中的路径进行排序/排序
我正在使用NSwag为.NET Core API生成招摇工具，并且一切正常，除了渲染路径以使反射似乎将Controller从项目中提取这一事实之外. 因此，如果我确实具有层次结构-某些控制器位于根级别( Controllers 文件夹)，而某些位于子文件夹( Controllers \ Subfolder 文件夹)，则顺序会混乱. 是否可以通过某种方式告诉NSwag生成结果 swagg
..
我们如何通过Windows身份验证保护Swagger UI
我们有一个.net Core 2.2 Web Api，它使用swagger ui公开Web Api定义.我们希望将此端点仅保护给特定AD组内的用户.我们目前正在同时使用Windows和匿名身份验证.问题是我们无法强制Swagger使用Windows身份验证来阻止用户. 有什么想法吗? 解决方案 尽管令人沮丧，但到目前为止，我发现保护Swagger端点(通过Swashbuckle)
..
.Net Core 3.1删除Swagger UI上的架构
我有.Net 3.1 Web Api，我想删除此部分中的“模式"，在Swagger UI上. 怎么做?
..
Net Core:Swashbuckle将operationId自动设置为控制器操作方法
在创建现有API的Angular API服务代理时，我们试图覆盖Swashbuckle/Swagger IO CodeGen的命名约定，以适用于现有500多个控制器和相应的方法. 当前将Net Core 3 API与Angular Typescript链接. https://stackoverflow.com/a/58567622/13889515 以下答案有效: [Http
..
指示Swagger UI中复杂输入参数对象的必需属性
在这种方法中 //////获取活动日志.//////位置ID.///活动日志过滤器选项./// OK[ResponseType(typeof(Activity
..
在API提取和浏览器崩溃后，Swagger UI冻结
我有一个ASP.NET WebAPI项目，我试图用Swagger UI替换旧的XmlDocumentationProvider页面.我正在为WebAPI 5.3.1使用 swashbuckle大招 nuget包. 我能够导航到localhost/MyApp/swagger，并且在提琴手中看到它调用了localhost/MyApp/swagger/docs/v1来检索表示我的API的JSON字
..
使用Google Cloud Endpoints进行非OAuth2 JWT验证
我的用例 我在Google Cloud Platform上部署了一个API，并且使用Google Cloud Endpoints作为API Manager.对于那些熟悉端点的人，我在 文档中所述，请求来自操作在Google上，“授权"标头中包含令牌(JWT格式) authorization: "" 所以我需要使用Cloud Endpoints验证此令牌.
..
在Swagger UI中，如何从“匿名"菜单中删除挂锁图标.方法?
我正在使用.Net Core 2.1创建一个API，并使用JSON Web令牌(JWT)进行身份验证. 我有2个控制器:AuthenticationController和UserController. 我已经用[AllowAnonymous]装饰了AuthenticationController，并用[Authorize]装饰了UserController. Swagger运行正常:它
..
JSON模式-不同对象的数组
我想知道如何为不同对象的数组指定JSON模式. 此线程给了我答案的一半，但是当我有每种对象的多个实例时失败. 这是基于产品"对象:- { "things": [ { "entityType" : "Product", "name" : "Pepsi Cola", "brand" : "pepsi" }, { "
..
如何从Swagger API声明生成JSON-Schema
我有使用 Swagger v 1.2 我对Swagger的最初感觉是，它非常接近JSON Schema(草案3和最近的Draft 4)，并且为请求和响应对象生成JSON Schema相对容易. 但是，尽管Swagger的一部分重用了JSON Schema结构，但事实证明，它仅使用功能的子集，并且还在Models中引入了它自己的继承(使用subTypes和discriminator).
..
有没有一种方法可以将Swagger仅用于验证而无需使用整个框架?
假设我有一个实现JSON HTTP API的现有Java服务，并且我想添加一个Swagger模式并针对它自动验证请求和响应，而无需重新构建该服务以使用Swagger框架/代码生成.有没有提供我可以绑定的Java API并传递有关请求/响应的信息以进行验证? (仅使用JSON模式验证器就意味着在Swagger中手动实现许多其他功能.) 解决方案 我认为没有单独准备做任何事情的方法，但是
..
Swagger模式中的oneOf不起作用
我想如下定义PaymentMethod. swagger.yaml是否支持oneOf? PaymentMethod: oneOf: - $ref: '#/definitions/NewPaymentMethod' - $ref: '#/definitions/ExistPaymentMethod' ExistPaymentMethod仅具有i
..
C#库，用于将JSON模式转换为示例JSON
我正在寻找一个C#库，该库将基于给定的JSON模式生成一个有效的JSON对象.我想生成一个非常简单的JSON示例，就像 Swagger 那样做: 我已经看到了一些JavaScript库，例如 JSON Schema Faker ，但是我需要一个C# /.Net库，可以在我的后端代码中生成示例JSON. 解决方案 好，它非常简单，没有考虑JSON模式的许多因素，但对于您来说可能是一个足
..
如何在不创建对象的情况下将Java类转换为json格式结构
我需要记录多个微服务api调用，所以我有一个问题，如何直接从java pojo类中创建json字符串.我的意思是说， MyPojo.java public class MyPojo { String name; List address; public MyPojo() { // TODO Auto-generated constructor stub } //
..