swagger - как добавить пользовательские параметры заголовка в детали запроса

Question

 parameters:
  - in: "body"
    name: "body"
    description: "Pet object that needs to be added to the store"
    required: true
    schema:
      $ref: "#/definitions/Pet"
  - in: "header"
    name: "user"
    description: "username in header paramter"
    required: false

Добавление приведенных выше строк кода в POST-запросе примера, приведенного в
https://editor.swagger.io/

Это дает мне ошибку

Answer 1

Вашему параметру заголовка требуется type.

  - in: "header"
    name: "user"
    description: "username in header paramter"
    required: false
    type: string    # <-----------