Swagger.io/OpenAPI-如何重用完整的代码块



我有来自服务器的状态代码,这些代码在文档中不断重复:

responses:
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'402':
$ref: '#/components/responses/402'
'403':
$ref: '#/components/responses/403'
'404': 
$ref: '#/components/responses/404'
'426':
$ref: '#/components/responses/426'
'429':
$ref: '#/components/responses/429'

我如何使用Swagger.io的OpenAPI来放置引用,以便一次只能有一条短线,例如:

responses:
$ref: '#/components/responses/defaultCodes'

是否也可以用";allOf";?

responses:
allOf:
- '200':
$ref: '#/components/responses/200'
- $ref: '#/components/responses/defaultCodes'

非常感谢您的帮助:(

这是不受支持的。

以下是OpenAPI规范存储库中的相关功能请求:

  • 添加默认响应
  • 性状或混合物
  • 将多个参数定义分组以获得更好的可维护性(即使是关于参数的,通用解决方案也可以扩展到响应(

最新更新