swagger 相关问题

OpenAPI/Swagger：定义具有一个必填字段和互斥可选字段的 JSON 有效负载

我正在为具有特定负载结构的 API 端点创建 Swagger/OpenAPI 规范： 1 个字段为必填字段 两个附加字段是可选的 只能选择其中一个可选字段

使用 Flask 和 Swagger 公开 API 文档

我已经用 Flask 构建了一个小型服务，并且已经编写了一个 swagger yaml 文件来描述它的 API。如何通过 Flask 应用程序公开 swagger 文件？ 我并不是有意公开文件本身（

在尝试更改标头身份验证密钥名称后，我在使用 Swagger UI 进行身份验证时遇到一些问题

我在使用 Swagger UI 进行身份验证时遇到一些问题。 我修改了 lexik_jwt_authentication.yaml 文件，从授权标头中提取名为“X-Authoriza...

在 API 版本控制中处理多个版本

使用 C# 和 .net 6 我已经在我们的应用程序中实现了 API 版本控制，但对实现很少有疑问，并且需要有关代码适当可维护性的建议。 不是我们的全部

如何将自定义Springdoc资源添加到swagger-ui页面

我不擅长 swagger 和相关库，如果标题令人困惑，很抱歉。 我有几个服务以 json 格式并通过 swagger-ui 提供它们的 api 作为 swagger 文档。接下来，...

针对不支持的操作的 HTTP 服务器行为和 REST API 规范

我有一些REST API的规范，并且我也在开发相应API的一些实现。 问题出现了，我的实现应该为操作返回什么 HTTP 状态代码...

如何确认我的 API 中使用的 swagger 版本？

我已将我的 REST API（在 Jersey 上开发）与 swagger 2.0 集成 但是当我看到 Json 列表时，它显示了以下条目： "api版本": "1.0.0", "swagger版本": "1.2",

如何在 Node.js 中使用自定义 CSS 设计 Swagger API 文档样式？

我正在尝试设计我的 Node.js Swagger API 文档，尽管阅读了资源，但我似乎无法使其工作。最初我坚持使用 npm 的官方文档以及他之前的一些讨论......

Swagger with Flask 中的下拉菜单（restx）

我正在使用flask-restx 库构建我的第一个API。我用它来生成带有注释的 API 的 Swagger 文档。我目前有一些用于 post 方法的字段，但它们都接受输入...

如何在 OpenAPI 中弃用整个 API？

我想找到一种方法将 API 标记为已弃用。 这是一种可能的情况：开发了 GraphQL API，而不是 REST API，但为了顺利停用旧的 REST API，我想...

springdoc-openapi v2.6.0 未公开 Swagger-UI

我正在使用以下版本： spring-boot-starter-parent：3.3.3 java.版本：21 spring-cloud-版本：2023.0.3 springdoc-openapi-starter-webmvc-ui：2.6.0 当我运行应用程序时...

swagger 即使未找到对象也会返回 403 错误

`@PostMapping(“/插入”) @Operation(summary = "Создать раздел и подразделы") @SecurityRequirement(name = "承载身份验证") @ApiResponses(值 = { @

为 Swagger 生成离线文档

我需要为 Rest/Json api 生成离线文档（PDF / docx / Standalone html），但有一些限制： 我无法访问 JVM 或 Docker 它需要可靠（没有在线网站......

blob 的 Swagger 规范表示

我正在为新端点创建一个 swagger 规范，该端点将接收作为二进制数据的文件。您如何在 swagger 规范中表示这一点？我将对象视为一种数据类型，但它没有出现......

在 IIS 上使用 swagger 发布 Web api

在遵循此示例文档后，我正在尝试弄清楚如何使用 Swagger (SwashBuckle) 发布 .net core 3 API。所以它可以在本地运行，当我按 F5 IIS Express 时，会启动该网站...

我可以自动生成 Clockify 的 API 客户端吗？

我正在编写一些 PHP 中间件来将 Clockify 连接到 Xero。 这两个平台都提供精细的 REST API，因此我应该能够相对轻松地在两个平台之间移动数据。 Xero提供API客户端...

Swagger API V3 中的 GraalVM 本机构建中的文件上传显示文本输入而不是文件上传

当我在 Spring boot V3 中开发一个新的反应式端点时，如下所示： @RestController @RequestMapping(“/统计”) 公共类 StatsController { @PostMapping( 消耗=媒体...

无法分配给函数“function () { [native code] }”的只读属性“name” - Fastify Swagger

我为毕业项目创建了一个简单的财务 API，我正在尝试使用 Swagger 来记录该 API。但在 Swagger 上却出现了这个错误。有人可以帮助我吗？ 有问题的错误： { ...

在program.cs中使用选项模式

我在应用程序内部使用选项模式，从 appsettings.json 文件中读取属性，并在整个应用程序的类中使用它们。 但是，我有一个情况需要......

在 Spring 5 而非 Spring Boot 中记录 API 的最佳方式

我正在尝试为我的 Spring 5 项目中的所有 API 添加 swagger 文档。我无法找出最好的方法。我看到我们可以使用 springdoc openapi 但大部分文档......