“内容”：在Swagger/OpenAPI“响应”中是什么意思：

Question

使用Swagger/OpenAPI（以及随后的swagger-codegen）我还没能找到两者之间的区别

这是从https://swagger.io/specification/#responseSobject（第一个示例，json格式）中获得的Directy

"responses" : {
  "200": {
    "description": "a pet to be returned",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Pet"
} } } } }

和

"responses" : {
  "200": {
    "description": "a pet to be returned",
    "schema": {
      "$ref": "#/components/schemas/Pet"
} } }

responses:
  200:
    description: "a pet to be returned"

responses:
  200:
    description: "a pet to be returned"
    schema:
      $ref: "#/components/schemas/Pet"

内容是什么意思？我在这个示例中遗漏了什么，为什么内容没有导致非none返回类型和相应的模式。

关于swaggercodgen的注意事项：生成的代码与生成的yaml所说的完全匹配，因此我在这里没有包含任何这些细节

Answer 1

第一个示例是OpenAPI3.0，第二个示例是OpenAPI2.0，因此不同。

OpenAPI3.0中使用的content关键字替代了OpenAPI2.0中的consumes/produces。在responsessions上下文中，content表示响应具有正文并指定媒体类型（json/xml/等）和响应体的结构。

OpenAPI 2.0版本：

swagger: "2.0"
...
paths:
  /foo:
    get:
      produces:
        - application/json
      responses:
        200:
          description: OK
          schema:
            $ref: "#/definitions/Pet"

openapi: 3.0.0
...
paths:
  /foo:
    get:
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Pet"

null