Можем ли мы установить глобальные "потребляет" и "производит" в Swagger?

В каждом пути мне нужно установить consumes а также produces, Могу ли я установить их глобально?

post:
      summary: ""
      description: ""
      consumes:
      - "application/json"
      - "application/xml"
      produces:
      - "application/xml"
      - "application/json"

1 ответ

Решение

Конечно. Вы можете указать consumes а также produces на корневом уровне спецификации, и они будут наследоваться всеми операциями. Глобальный consumes а также produces при необходимости может быть переопределен на операционном уровне.

consumes:
  - application/json
  - application/xml
produces:
  - application/xml
  - application/json

paths:
  /foo:
    get:
      # This inherits global `produces`
      ...

    post:
      # Here we override global `consumes`
      consumes:
        - application/x-www-form-urlencoded
      ...

Дополнительная информация: https://swagger.io/docs/specification/2-0/mime-types/

Другие вопросы по тегам