gpt4 book ai didi

swagger - 在 "host"级别覆盖 "basePath"和 "/{path}"

转载 作者:行者123 更新时间:2023-12-02 10:26:38 25 4
gpt4 key购买 nike

问题陈述:

出于“奇怪”的原因,我们对 API 的所有操作都有不同的“主机”。我们有这样的 API:

  • 操作 1:GET https://host1:port1/api/resources
  • 操作 2:GET https://host1:port2/api/resources/{id}
  • 操作 3:POST https://host2:port3/api/resources
  • 操作 4:POST https://host2:port4/api/resources/search

如果我们按原样使用 Swagger/OpenAPI,则意味着每个操作创建一个 Swagger/OpenAPI 规范,导致每个操作都有一个 swagger-ui 页面,然后需要重新创建一个索引页面来列出所有操作API 的操作:-/这正是我们想要避免的。

问题:

1/此功能 - 在“/{path}”级别覆盖“host”和“basePath” - 有意义吗?

2/有人已经尝试在 swagger-ui 中实现此功能吗?

3/我可以/应该向 OpenAPI 提出这种更改吗?

欢迎任何其他有用的评论/评论;-)

最佳答案

OpenAPI 3.0 现在支持在路径或操作级别覆盖目标服务器:

openapi: 3.0.0

servers:
- url: https://my.api.com/v1

paths:
/foo:
# Override the server at path level
servers:
- url: https://another.server:8443/basePath

get: ...
post: ...

/bar:
get:
# Override the server at operation level
servers:
- url: https://some.other.server/v2

post: ...

关于swagger - 在 "host"级别覆盖 "basePath"和 "/{path}",我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/37157721/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com