173得票7回答
如何在Swagger规范中使用'Authorization: Bearer <token>'?

我试图传达的是,身份验证/安全方案需要设置一个头部,如下所示: Authorization: Bearer &lt;token&gt; 这是我根据swagger文档所得出的内容: securityDefinitions: APIKey: type: apiKey n...

135得票15回答
如何配置Spring Security以允许无需认证访问Swagger URL

我的项目使用了Spring Security。 主要问题:无法访问http://localhost:8080/api/v2/api-docs的Swagger URL,显示缺少或无效的授权头。 浏览器窗口截图 我的pom.xml文件包含以下条目&lt;dependency&gt; &l...

119得票13回答
Swagger/OpenAPI模拟服务器

我有一个Swagger文件中的API参考文档,我想创建一个非常简单的模拟服务器,这样当我调用例如: mymockurl.com/users 时,它会返回预定义的JSON(无需连接到数据库)。 最简单的方法是什么?我不是后端开发人员。

114得票3回答
如何基于现有的Postman集合生成Swagger文档?

我正在开发一个REST API。在开发过程中,我使用了Postman(Chrome扩展程序)来使用和记录我的API。这是一个很棒的工具,我把大部分的API端点都放在了里面。 然而,随着我们接近发布,我想用Swagger来记录这个API,我该如何做呢?有没有办法可以根据Postman导出的内容生...

106得票13回答
Swagger类型错误:无法在“Window”上执行“fetch”:使用GET/HEAD方法的请求不能有正文。

我已经将Swagger添加到了我的Spring Boot 2应用程序中:这是我的Swagger配置: @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() ...

101得票2回答
Swagger/OpenAPI - 使用 $ref 传递可重用的定义参数

假设我有一个参数叫做limit。这个参数在许多地方都被使用,如果我需要更新它,那么要到处修改它就很麻烦:parameters: - name: limit in: query description: Limits the number of returned ...

92得票20回答
如何在Swagger-UI中打开本地文件

我想使用swagger-ui在本地计算机上打开自己生成的Swagger规范文件my.json。 因此,我下载了最新的标记v2.1.8-M1并解压缩了ZIP文件。然后我进入子文件夹dist并将文件my.json复制到其中。现在我打开了index.html并想要探索my.json。这里问题开始出...

83得票2回答
如何在OpenAPI(Swagger)2.0中将字段标记为已弃用?

我有以下模式定义:swagger: '2.0' ... definitions: Service: type: object properties: serviceId: type: string description: Dev...

83得票4回答
如何在OpenAPI(Swagger)中定义枚举?

有人知道如何在OpenAPI 2.0定义中定义可能的enum值,以便它们会显示在Swagger UI的模型选项卡中吗?这里的示例有一个status属性的枚举选项。 如何在OpenAPI 2.0中定义这样的枚举?

82得票2回答
如何格式化Swagger 2.0文本描述?

我希望能够将我的Swagger API描述格式化,使其不只是简单的文本段落。最好能够在其中添加一个小表格。我没有在Swagger描述中找到有关文本格式的在线参考资料。如果我启动Swagger Editor,并打开Instagram示例(文件\打开示例\Instagram.yaml),则可以看到...