swagger 相关问题

swagger 有时会在 NestJS API 的 UI 中缺少参数

我正在使用 swagger 来测试和查看 API 的详细信息，但有时它不会在一个调用中显示查询参数，但会在另一个调用中显示，例如这个。该帖子显示正确，但得到...

Swagger $ref 给出“无法解析引用：未定义未定义”

所以我试图将我们在响应正文中给出的对象分离到单独的 yaml 或 json 文件中，并且它始终给出相同的错误。 错误 paths./api/thing.get 处的解析器错误。

如何在ApiPlatform（Symfony）中的swagger中添加控制器端点？

我使用 ApiPlatform 并希望在控制器中拥有很少的端点。 如何使这些端点对 swagger 可见以及如何提供 swagger 文档信息（例如描述）？ 我尝试添加#[

Microsoft.OData.Client 与 Microsoft.OData.Core 7.0

我需要在我的项目中使用 Microsoft.OData.Client，它已经引用了 Microsoft.OData.Core 7.0.0 和 Microsoft.AspNet.OData 6.0。 其实我没有找到兼容的客户端版本...

拥有外部 Swagger JSON 以及 Springdoc 生成的 Swagger

我正在开发一个与 Camunda 集成的 Spring 应用程序。它公开 Camunda 和自定义端点。我想将两个 Swagger 保留在应用程序中，如下所示： 但一旦我...

fastapi swagger 文档未将列表数组渲染为查询参数

根据文档，可以传递值列表https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#query-parameter-list-multiple-values。 我已尽力而为

Swagger 3 在 SpringBoot 3 中获取 Whitelabel 错误页面

我正在Springboot 3中制作API。当我添加此依赖项时，我在http://localhost:8080/swagger-ui/index.html或其他链接处收到whitelabel错误页面。我还添加了@EnableWebMvc @Compone...

Swagger/Swashbuckle：忽略基类中的重载端点

我有一个带有搜索（字符串查询）方法的基本控制器类，路径为/search。我有一个带有搜索（字符串查询，字符串名称）的子类，也带有路径/搜索。 Swagger API

OpenAPI 规范：查询参数的默认值被忽略

我将 OpenAPI 3 规范中的参数描述为 审查请求： 得到： 标签： - 仪表板 操作 ID：reviewRequests 参数： - 名称：页面 在：查询 d...

API方法排序：Swagger版本3.0.2

我正在使用 swagger 版本 3.0.2 ，我也遵循了这个答案，但对方法顺序没有影响。 窗口.onload = 函数() { const ui = SwaggerUIBundle({ …… apisSorter：&...

导致 swagger 已在 Web API 2 的路由集合中的错误是什么？

我在 ASP.Net MVC Core 项目中安装了 Swagger，它完美地记录了我的 API。 我的同事要求我将其安装在完整的框架 4.6.1 项目中，所以我完成了以下操作。 在 P...

Spring Boot 和 Swagger UI。设置 JWT 令牌

我有一个像这样的 Swagger 配置 @EnableSwagger2 @配置 公共类 SwaggerConfig { @豆 公共 Docket api() { 列表schemeList = 新的ArrayList<&...

openapi / swagger 示例未显示

我正在使用 spring-boot 3.2 这是我的依赖项： pom.xml org.springdoc springdoc-openapi-starter-

SpringBoot应用程序中API请求的ASCII符号字符编码问题

我正在开发一个使用 OpenAPI 生成 API 的 Spring Boot 应用程序。端点之一 sendEmail 接受包含 toAddress、主题、emailBodyAsHtml 和 Attachme 的请求正文...

Swagger - 使用文档授权对 url 的请求

我想知道 Swagger 中是否有一个选项可以授权对包含外部文档的 url 的请求。 我有以下配置，我感兴趣的是 urls[1] 部分 春天...

在 Asp.net Swagger 架构中包含枚举的可能值

在我们的 ASP.net Core Web API 中，我们的 DTO 具有字符串属性，其有效值在枚举中定义。 （我们计划将这些属性的类型更改为相应的枚举，但是不...

在 Swagger（drf_yasg 库）中针对 Django 中的嵌套序列化程序出现错误

我在 django 中使用 drf_yasg 库。正常情况下一切正常。当我使用嵌套序列化器时，我在 swagger 界面中收到以下错误。 **错误： ** 内部服务器呃...

drf-壮观的extend_schema原始数据

我正在尝试发送原始数据做extend_schema扩展_schema装饰器以仅通知yml文件并创建swagger文档 defextend_schema_from_yaml（yaml_file_path，操作_id =无...

如何使用 Swagger 注释订购 API 端点 (Springfox)

我希望用 @ApiOperation 标记的控制器端点在 Swagger 规范中按特定顺序出现。尝试像这样在 @ApiOperation 上设置位置： @ApiOperation(值 = "xxx", 位置 = 1...

spring 3 更新后找不到 swagger 3 导入

有类似我的问题的帖子，但我有所有正确的依赖项。我还有另一个正在使用 swagger 3 的应用程序，我刚刚更新到 spring 2 -> 3。我很挣扎......