32得票1回答
Swagger UI中的对象枚举?

我在我的Swagger规范中有一个其他定义的枚举:"action": { "title": "Action", "description": "Action to apply to matching requests", "type": "object", "enum": [ ...

21得票2回答
如何在OpenAPI(Swagger)中将$ref属性声明为只读?

我试图在这个例子中为“House”添加一个只读字段。房屋是另一个我想要设置为只读的模型。 在这个例子中,狗的数组可以设置为readOnly而不会出错,但是当我将House的单个定义设置为readOnly时,Swagger编辑器会显示以下警告: $refs旁边不允许有兄弟值。 我理...

19得票4回答
Spring Boot使用Spring Fox实现Swagger时,无法启动bean 'documentationPluginsBootstrapper'。

我在我的Spring Boot项目中使用Springfox Jars来实现Swagger,Gradle的依赖项如下: dependencies { compile group: 'org.springframework.boot', name: 'spring-boot-starter-we...

20得票3回答
将JSON转换为与Swagger 2.0兼容的JSON Schema草案4。

我收到了由REST API生成的JSON文件,其中包含许多属性。 我为这个API创建了一个Swagger 2.0定义,并需要为响应提供相应的模式。 主要问题是:这个JSON文件有很多属性。如果我手动编写模式,将会花费很多时间并且容易出错,而且这不是我需要描述的唯一API。 我知道有一些工...

7得票1回答
合并多个Swagger文件

我的项目使用RESTful API,供应商提供了Swagger 2.0 json文件。由于供应商没有SDK,因此我正在使用Swagger文件生成一个初始点来用于与服务集成。它分为50多个文件,按端点集合分组。我该如何将它们合并成一个符合规范的单个JSON或YAML文件,以便一次生成所有端点的S...

10得票6回答
Swagger UI上的CORS问题

请问有人可以告诉我为什么会出现这些错误吗? GET http://127.0.0.1:9000/api-docs/service.json 200 OK 4ms swagger-ui.js (line 30261) Unable to Load SwaggerUI /ap...

7得票3回答
Swagger UI发送的请求为什么缺少Authorization头?

我想为我的Node.js API添加文档,我已经编写了一个YAML文件来定义API接口,Swagger文档位于localhost:5000/api-doc并且运行良好。 现在我需要使用以下定义来添加Bearer授权到Swagger: swagger: "2.0" info: ver...

18得票2回答
如何在Swagger规范中表示十进制浮点数?

我希望在我的API文档中用2位小数和1位小数表示十进制数。 我正在使用Swagger 2.0,规范中是否有内置定义类型或任何其他“round”参数,还是我唯一的选择是使用“x-”扩展?

22得票1回答
Maven: 包io.swagger.annotations不存在

我想用Swagger记录我的项目。我在项目中添加了Swagger注解和io.springfox依赖项,但是当我运行mvn clean package时,出现了很多错误。 PS D:\parent-project> mvn clean package [INFO] Scanning fo...

24得票2回答
Swagger UI配置与swagger-config.yaml

根据Swagger文档, Swagger-UI在四个位置接受配置参数。 从优先级最低到最高依次为: 1. 如果在项目根目录中存在swagger-config.yaml,则将其嵌入应用程序。 2. 作为参数传递给Swagger-UI(SwaggerUI({...}))的配置对象。 3. 从...