Swagger 2.0 Accept-Language header 作为请求参数

Question

我正在使用 Swagger 2.0 为 http API 编写规范。

如何将 Accept-Language header 定义为路径的必需 header 参数？

/aPath:
post:
  parameters:
    - in: header
      name: Accept-Language
      type: string
      enum: [de, en, es]
      required: true
  responses:
    200:
      description: The Best
      schema:
        type: string

Documentation on header parameters 说

Swagger specification has special keywords for some headers:

如何使用关键字 produces 来定义 Accept-Language header？

Answer 1

你的定义是正确的。

您提到的页面谈到 Accept header, which is different from Accept-Language。