параметр swagger - заголовок переопределяет объект XML для корневого объекта в схеме

  parameters:
    - name: message
      in: body
      schema:
        type: object
        title: Ping_Request
        xml:
          name: message

в пользовательском интерфейсе swagger примером для этого будет

<?xml version="1.0"?>
<Ping_Request>

Для вложенных объектов он работает нормально (для этого объекта используется имя тега из объекта XML, а не из заголовка). И для корневого объекта схемы результата это тоже нормально.

Проблема для корневого объекта только в параметре тела.


openapi swagger swagger-ui
person Andrey Sorokin    schedule 18.08.2016    source источник
comment
Обходной путь, который я нашел - используйте $ ref, в этом случае все в порядке, но я хочу, чтобы спецификация была внутри описания сообщения, а не в разделе спецификации спецификации.   -  person Andrey Sorokin    schedule 18.08.2016

Ответы (1)


arrow_upward
0
arrow_downward

Скорее всего, это была ошибка в используемой вами версии пользовательского интерфейса Swagger. Версия 3.0.5 отображает пример XML с правильным корневым тегом:

<?xml version="1.0" encoding="UTF-8"?>
<message>
</message>
person Helen    schedule 11.04.2017