如何在OpenAPI3.0中定义头参数？

Question

paths:
  /post:
    post:
      parameters:
        - in: header
          name: X-username

但是在OpenAPI3.0.0中，参数被请求体替换，我找不到定义头参数的方法，这将进一步用于身份验证。

在OpenAPI3.0.0中定义请求头的正确方法是什么？

Answer 1

在OpenAPI3.0中，头参数的定义方式与OpenAPI2.0中相同，只是类型已被模式替换：

paths:
  /post:
    post:
      parameters:
        - in: header
          name: X-username
          schema:
            type: string

如果有疑问，请查看描述参数指南。

但是在Swagger 3.0.0中，参数被请求体所取代。

components:
  securitySchemes:
    usernameHeader:
      type: apiKey
      in: header
      name: X-Username

paths:
  /post:
    post:
      security:
        - usernameHeader: []
      ...