问题标签 [swagger-2.0]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
416 浏览

java - swagger2:需要失败的uri(没有弹簧)

尝试使用 swagger 2,但我有一个 uri 配置问题。这是我的构建输出和我的 pom.xml 配置。

Maven 中的这个 uri 错误是什么意思?

Maven输出:

这是我的 pom.xml 配置

0 投票
1 回答
12051 浏览

swagger - Swagger 2.0 中的 JSON API 示例

我正在尝试使用 Swagger 2.0 为端点创建示例响应。

我的 api 消费和生产application/vnd.api+json,但它不会识别它。如果我删除这些示例,我的规范就会起作用。知道如何指定它吗?

错误

0 投票
2 回答
2354 浏览

maven - How to set overriding models in swagger-maven-plugin 3.1.0

How to set overriding models in swagger-maven-plugin 3.1.0 and Swagger UI 2.0 (or newer versions)?

Recently we've upgraded Swagger UI from 1.2 to 2.0 and swagger-maven-plugin from 2.3 to 3.1.0.

It appears, that swagger-maven-plugin version 3.1.0 is missing the overridingModels option, that was present in version 2.3.

The option enabled us to customize schema description for certain data types, as described in: https://github.com/swagger-api/swagger-core/wiki/overriding-models.

0 投票
1 回答
378 浏览

java - 如何在 Spring boot 和 Swagger 2.0 中自定义 tom 级别的属性?

有人知道如何在 Spring Boot 和 Swagger 2.0 中自定义汤姆级属性吗?

我尝试使用@SwaggerDefinition,但这似乎不起作用。我下面的代码有什么错误吗?

我从http://localhost:8080/v2/api-docs得到以下 json 响应

顶级属性(标题,描述)应该已经改变。

0 投票
1 回答
4773 浏览

java - 我可以在 Swagger 的 @ApiOperation 中做出什么回应

在这段代码中,当此方法返回 Response.noContent.build(); 时,我可以使用 Status.class @ApiOperation 吗?

0 投票
1 回答
2904 浏览

spring - Swagger Springfox 注释不起作用

这些是我正在尝试制作的示例应用程序的方法标头。不幸的是,我没有看到 @ApiOperation 或 @ApiResponse 或 @ApiResponses 注释生效。我还有一个示例类和一个应用程序类(其中包含招摇的配置信息等)

这是我招摇 json 的相关部分

我正在使用 springfox-swagger2 2.1.1 版,我正在通过 swagger 在他们的现场演示应用程序中提供的默认 UI 查看我的 UI。

有人可以告诉我我做错了什么吗?谢谢!

0 投票
1 回答
1493 浏览

rest - Swagger 给对象引用错误

在 VS2013 WebAPI 项目上运行 swagger 时,出现以下错误

完成的步骤 1.安装 SwashBuckle Nuget 包 2.修改 Swagger.cs 文件以包含所需的基本代码。3.运行WebApi。4. 在 API url 中附加 /swagger。

执行第 4 步后,出现上述错误。

请帮忙。

0 投票
1 回答
819 浏览

swagger - 节点上的 swagger-tools:如何从 basePath 提供 swagger-ui

使用 nodejs 和 swagger-tools v0.8.7 来路由端点。

api/myapi.json 中的 "basePath": "/api/myapi" 效果很好,即:http://localhost:3000/api/myapi上的 GET、POST 等。

但我仍然必须访问http://localhost:3000/docs/才能使用 UI 工具。如何从http://localhost:3000/api/myapi/docs/提供此服务 ?

在 /api/myapy/api-docs 而不是 /api-docs 提供 yaml 的问题相同。

谢谢。

0 投票
1 回答
714 浏览

java - 属性“年”的冲突设置器定义 (Springfox-Swagger2)

我的问题与以下问题相同;

Jackson POJOPropertyBuilder 在 POJO 中找到多个 setter

但是,当我使用“springfox-swagger2”时,我不使用SwaggerSpringMvcPlugin.

有没有办法解决这个问题?

应用程序.java

0 投票
2 回答
2247 浏览

java - 无法使用访问 swagger 文档/api-文档

我正在尝试使用 Jersey 和 swagger 构建 Hello World REST 服务来生成文档。我能够成功调用其余方法,但是当我尝试通过调用访问 swagger 文档时:

我得到“404 未找到”。(我也尝试将 .json 添加到末尾)

我按照本教程中的步骤构建了我的服务。

我的 web.xml:

这是我的 pom.xml:

最后,这是我的服务类: