http - Swagger 2.0 Accept-Language 标头作为请求参数

Question

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

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

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

有关标头参数的文档说

Swagger 规范对某些标头有特殊的关键字：

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

Answer 1

你的定义是正确的。

您提到的页面谈到了Accept标题，它与Accept-Language.