Пример схемы содержащей oneOf SwaggerUI

Пишу документацию на OpenAPI 3.0.2 и возникла проблема в отображением в Swagger В общем:

Есть ответ с кодом 200:

responses:
  200:
    description: Узел структуры успешно найден
    content:
      application/json:
        schema:
          oneOf:
            - $ref: 'components/schemas.yaml#/SectionItem'
            - $ref: 'components/schemas.yaml#/PageItem'

Так вот при такой схеме в Swagger не отображается никакой пример, а очень хочется.

Может кто-то сталкивался с такой проблемой?

И есть второй вопрос:

У меня есть ответ с http кодом 400, который может включать в себя целый ряд ошибок и они зависят от параметра возвращаемого в json теле ответа, например:

{"error": {"code": 400001, "message": "Incorrect query param"}}. 

Вопрос знатокам, как можно описать все вариации ошибок?


Ответы (0 шт):