OpenAPI 3在参数之间添加RequestBody

Question

我想知道是否可以在两个查询参数之间添加OpenAPI 3.0.1文件的RequestBody。我在文档中找不到任何关于这方面的东西。

Answer 1

在OpenAPI 3.x中，RequestBody和Parameters (查询、标题等)位于不同的部分。例如：

  parameters:
    - name: petId
      in: path
      description: ID of pet to return
      required: true
      schema:
        type: integer
        format: int64
    - name: petType
      in: query
      description: type of food
      required: true
      schema:
        type: string
    - name: status
      in: query
      description: status
      required: true
      schema:
        type: string
    - name: sessionId
      in: cookie
      description: session id
      required: true
      schema:
        type: string
    - name: token
      in: header
      description: status
      required: true
      schema:
        type: string
  requestBody:
    description: Pet object that needs to be added to the store
    content:
      application/json:
        schema:
          $ref: '#/components/schemas/Pet'
      application/xml:
        schema:
          $ref: '#/components/schemas/Pet'
    required: true

参考：https://github.com/swagger-api/swagger-codegen-generators/blob/master/src/test/resources/3_0_0/petstore.yaml#L244-L285

所以我不明白你在两个查询参数之间添加RequestBody是什么意思。