Как описать HTTP redirect с параметрами в Swagger / OpenAPI v.3?

Question

[Сергей Соколов]

Как в спецификации Swagger / OpenAPI v.3 можно описать, что при обращении к определённому методу GET /some/method вернётся 302 redirect на определённый URL с определёнными параметрами?

Answer 1

[Алексей Ярков]

https://swagger.io/docs/specification/describing-r...
Раздел HTTP Status Codes или Response Headers

Comments

[Сергей Соколов]

я это как раз и читаю до дыр, но не понимаю, как в описании заголовка Location указать, что там параметром XXX будет непременно JWT с такой-то схемой. Можно отложить схему данных внутри JWT, но как указать что имя параметра будет такое-то?

responses:
  "303":
    description: >-
      Перенаправляем пользователя на сайт A
      с JWT в GET-параметре "userdata"
    headers:
      Location:
        schema:
          type: string
        description: JWT с данными пользователя