swagger 请求头

Swagger是一个用于描述、构建、测试和使用RESTful Web服务的开源软件框架。在Swagger中，可以使用"parameters"字段来描述请求头信息。

以下是一个示例Swagger请求头的描述：

swagger: "2.0"
info:
  version: 1.0.0
  title: Swagger 请求头示例
host: api.example.com
basePath: /v1
schemes:
  - https
paths:
  /users:
    get:
      summary: 获取用户列表
      parameters:
        - name: Authorization
          in: header
          description: 访问令牌
          required: true
          type: string
        - name: X-Custom-Header
          in: header
          description: 自定义请求头
          required: false
          type: string
      responses:
        200:
          description: 成功返回用户列表
        401:
          description: 未授权访问
        403:
          description: 禁止访问

在上述示例中，我们定义了两个请求头参数。"Authorization"参数是必需的，并且位于请求头中，用于传递访问令牌。"X-Custom-Header"参数是可选的自定义请求头。