Можно ли использовать всю необработанную строку в качестве параметра в сваггере

Question

есть URL как http://someservice.com/confirm?{token}

Является ли это каким-либо образом, как описать эту конечную точку в терминах чванства

если использовать в качестве параметра запроса, вы получите

  /confirm:
    get:
      summary: ...
      parameters:
        - in: query
          name: token
        ...

http://someservice.com/confirm?token=value, что не в порядке

с другой стороны, невозможно использовать url-обозначение следующим образом:

  /confirm?{token}:
    get:
      summary: ...
      parameters:
        - in: path
          name: token
        ...

из-за того, что строки запросов в путях не допускаются.

Answer 1

В настоящее время это не поддерживается ни в OpenAPI 2.0, ни в OpenAPI 3.0.Вот соответствующий запрос функции:

Поддержка произвольных строк запроса