openapi

Я ищу элегантный способ определить api, который может потреблять данные JSON, а также данные формы. Следующий фрагмент работает, но он не элегантен и требует всего вида уродливого кода в бэкэнде. Есть ли лучший способ определить это? Что работает прямо сейчас: paths: /pets: post: consumes: ...

В OpenAPI (Swagger) 2.0 мы могли бы определить параметры заголовка следующим образом: paths: /post: post: parameters: - in: header name: X-username Но в OpenAPI 3.0.0 параметры заменяются телами запросов, и я не могу найти способ определить параметры заголовка, которые в даль...

допустим, у меня есть такой параметр, как limit. Это один привыкает повсюду, и это боль, чтобы изменить его везде, если мне нужно обновить его: parameters: - name: limit in: query description: Limits the number of returned results required: false type: number format: int32 ...