Python
Java
PHP
IOS
Android
Nodejs
JavaScript
Html5
Windows
Ubuntu
Linux
部署在代理后面的 springdoc-openapi-ui (Swagger UI) 中的“生成的服务器 url”错误
带有 springdoc openapi ui Swagger UI 的 Spring Boot 2 2 应用程序运行 HTTP 端口 该应用程序部署到 Kubernetes 并通过 Ingress 将 HTTPS 请求从集群外部路由到服务
springboot
swagger
SwaggerUI
openAPI
springdocopenapiui
Swagger / Open API 2.0 我可以声明通用响应标头吗?
是否可以声明一个自定义响应标头 该标头将出现在所有响应中 而无需将其复制到每个响应结构中 这在 OpenAPI 3 0 中有所改进 您现在可以在全局中定义通用标头components headers部分然后 ref这些定义而不是重复内联定义
openAPI
swagger20
在 Swagger Open API 3.0 中使用另一个参数时如何指示有条件地需要一个参数
我已经创建了一个 RESTful API 现在正在为该 API 的使用定义 Open API 3 0 JSON 表示形式 当存在另一个参数时 我需要有条件地使用一个参数 所以我也不能真正使用required true or required
swagger
openAPI
如何将 Springdoc Swagger UI 指向我自己的 YAML 文件而不是自动生成的文件?
我创建了一个 Spring Boot RESTFul 微服务 对于文档 我创建了一个 swagger yaml 文件 但我不知道如何运行该文件 为了创建 swagger yaml 文件 我使用了 OpenAPI 规范 我知道我们有一个 Sw
Java
springboot
swagger
openAPI
springdocopenapiui
委托设计模式在 Swagger 生成代码中的意义?
当我生成代码时Spring从我的 swagger yaml 中 通常控制器层是使用生成的delegate模式 以便为单个模型生成三个文件 例如 如果我定义了一个名为Person在我的 swagger open API yaml 文件中 生成
Java
swagger
openAPI
swaggercodegen
openapigenerator
Azure Functions V2 中的 OpenAPI(又名 Swagger)
我正在创建一个 V2 函数应用程序 并希望使用 Swagger Open API 来处理文档 但 Azure V2 函数门户尚不支持它 关于如何在 VSTS 中使用 Swagger 和 V2 函数在每个构建上创建文档 有什么建议吗 TL D
azuredevops
swagger
azurefunctions
openAPI
如何将 OpenAPI 2.0 转换为 OpenAPI 3.0? [关闭]
Closed 这个问题正在寻求书籍 工具 软件库等的推荐 不满足堆栈溢出指南 help closed questions 目前不接受答案 是否有任何工具 库可以将 OpenAPI 2 0 定义转换为 OpenAPI 3 0 而无需每行一个
swagger
openAPI
OpenAPI中如何定义全局参数?
我正在准备我的 API 文档 方法是手工完成 而不是自动生成 我有应该发送到所有 API 的标头 但不知道是否可以为整个 API 全局定义参数 其中一些标头是静态的 有些必须在调用 API 时设置 但它们在所有 API 中都是相同的 我不想
swagger
openAPI
端点“/api-docs”不适用于自定义 GsonHttpMessageConverter
我从 Springfox Swagger 迁移到 Springdoc OpenApi 我在有关 springdoc 的配置中添加了几行 springdoc pathsToMatch api api docs path api docs sw
springboot
kotlin
Gson
SwaggerUI
openAPI
如何在 Swagger UI 中删除“示例”组合框或更改其文本?
我的 Swagger UI 有一个问题 它显示一个空的 示例 组合框 下图中标记为黄色 看起来不太好 有没有办法删除它或将其文本更改为有用的内容 我尝试添加example标签 但它不起作用 操作定义如下所示 post tags pet su
SwaggerUI
openAPI
Swagger - 授权对带有文档的 url 的请求
我想知道 Swagger 中是否有一个选项可以授权对包含外部文档的 url 的请求 我有以下配置 我感兴趣的是urls 1 part springdoc swagger ui urls 0 url v3 api docs springdoc
springboot
swagger
openAPI
SpringDoc
如何在 OpenAPI (Swagger) 中定义枚举?
有谁知道如何定义可能enumOpenAPI 2 0 定义中的值以便它们显示在 Swagger UI 的 模型 选项卡中 示例在这里 https petstore swagger io pet addPet有一个枚举选项status财产 如何
swagger
SwaggerUI
swagger20
openAPI
OpenAPI 规范 (YML/YAML):所有 $refs 替换或扩展为其定义(带有模式验证)
我正在寻找一些解决方案或者一些脚本 可以帮助我通过模式验证替换 ref 或扩展其在 YML 文件中的定义 具体请看下面的例子 示例 使用 ref 输入 pets petId get summary Info for a specific p
Java
python
yaml
openAPI
Swagger 编辑器如何指定请求正文(POST)中的哪些字段是必需的?
我正在尝试在在线 Swagger 编辑器中的用户类上定义 POST 方法 我希望能够在请求正文中指定多个字段 并且我希望生成的文档能够反映只有 2 个字段是必需的 其他是可选的 我必须做什么 改变才能做到这一点 我已经尝试过使用 requi
openAPI
swaggereditor
如何将自定义 HTML 内容添加到 FastAPI Swagger UI 文档?
我需要在 FastAPI 应用程序的 Swagger UI 中添加一个自定义按钮 我发现这个答案 https stackoverflow com questions 74661044 add a custom javascript to t
python
swagger
FastAPI
SwaggerUI
openAPI
NSwag - 如何添加评论?
我在 ASP Net WebAPI 项目中使用 NSwag 来生成 swagger 界面 效果很好 假设我有一个方法想要添加一些解释 我该怎么做 我所说的注释是指当 API 用户查看文档时会看到的内容 我用谷歌搜索过 狂饮过 然后 躲开了
ASPNETCore
swagger
openAPI
针对单个端点多个帖子请求的开放 API 文档
我正在尝试为我的单端点 API 提供 Swagger Open Api 文档 我的单一端点看起来像 POST http localhost api v1 process http localhost api v1 process 帖子正文决
swagger
openAPI
OpenAPI 3.x.x 对可选参数的更改有不同的响应
我正在尝试为现有 API 创建 OAS Swagger 文档 其中 API 的响应根据查询参数而变化 我正在努力以开发人员友好的方式记录这一点 因此需要一些帮助 以下是完整的场景供您参考 端点 1 订单 展开 假 order expand
swagger
openAPI
apidocumentation
如何在使用 NSwag 生成的客户端方法名称中包含 Http 请求方法名称
当我使用 NSwag 为 API 生成 C 客户端时 其中 API 包含可与多种 Http 请求类型 例如 POST GET 一起使用的端点 客户端为每个请求生成一个具有相同基本名称和数字的方法 例如 使用此 API https api p
c
openAPI
nswag
Swagger 是什么?它与 OData 相关吗?
我熟悉 Microsoft 堆栈 我正在使用 OData 来提供一些宁静的服务 最近 我遇到了 Swagger API 文档 我试图了解它与 OData 的关系 两者看起来都是RESTful规范 哪一种被广泛使用 Swagger是一个规范记
ODATA
swagger
swashbuckle
openAPI
1
2
3
4
5
»