Flasgger header 参数未描述

Question

我尝试使用 flasgger 为项目实现 swagger 文档。当我描述 body 字段时 - 它工作正常，但是当我尝试描述 header 字段时，flasgger 不会在网络上显示参数的描述。

一个 .yml 文件示例。

description: Client side interaction with server
consumes:
- "application/json"
parameters:
  - in: header
    name: headers_params
    required: true
    schema:
      id: endpoint_header
      required:
        - session_token
      properties:
        session_token:
          type: string
          description: session token
  - in: body
    name: body_params
    required: true
    schema:
      id: endpoint_body
      required:
        - parameter1
        - parameter2
      properties:
        parameter1:
          type: string
          description: The parameter1 description
        parameter2:
          type: string
          description: The parameter2 description

responses:
  500:
      description: The error on the server side

  200:
      description: Access token for user intercation

而且，这是我在网上看到的： enter image description here

我应该遵循什么样的 .yml 文件结构来获取 header 以及 body 参数中描述的 session 令牌？

Answer 1

您似乎在使用 OpenAPI 2.0 语法。在OAS2中，header parameters是这样描述的：

  - in: header
    name: session_token    # <---- HTTP header name
    required: true
    type: string
    description: session token

或者，authentication-related headers 例如 session 标记可以描述为 security scheme, e.g. as an API key。

swagger: '2.0'
...

securityDefinitions:
  session_token:
    type: apiKey
    in: header
    name: session_token   # <---- HTTP header name

# Add the "security" section either on the root level (if all endpoints
# are secured with this token), or inside individual GET/POST/etc. operations
security:
  - session_token: []

Flasgger header 参数未描述

Flasgger header parameters aren't described

python

api

flask

swagger

flasgger