如何为 YAML 对象中的几个键设置一个值

Question

据我所知，没有办法将几个键附加到 YAML 中 {key : value} 对中的单个值。 我是 Swagger 文档（OpenAPI 3.0）的新手，想知道是否有可能以某种方式将我的价值观结合在一起。 例如，我正在搞乱 REST API 文档，当我想列出一些响应而不每次都重写时，我有以下内容：

paths:
  /users:
      post:
//some additional information here
        responses:
          '500':
//and for example here I want to add not only 201 status code but also others
                description: >-
                  Something went wrong on back end
//however I have to do something like this (writing them all)
          '502':
                description: >-
                  Something went wrong on back end
//and so on..

克服这个问题的最佳做法是什么？也许我从一开始就有一个不好的观点。

Answer 1

您可以使用锚点和别名：

path:
  /users:
    responses:
      '500':
        description: &desc1 >-
          Something went wrong on back end
      '502':
        description: *desc1

Answer 2

OpenAPI 3.0 支持响应范围'1XX'-'5XX'，可以使用它来代替单独列出代码：

    responses:
      '5XX':
        description: Something went wrong on back end

如果您仍想单独列出响应代码但它们具有相同的description 和schema，您可以像这样$ref 通用响应定义：

    responses:
      '501':
        $ref: '#/components/schemas/BackendErrorResponse'
      '502':
        $ref: '#/components/schemas/BackendErrorResponse'

components:
  responses:
    BackendErrorResponse:
      description: Something went wrong on back end
      content:
        application/json:
          schema:
            ...

OpenAPI 规范存储库中还有一个增强请求以允许reusing description across different responses。