Пример схемы содержащей 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"}}.
Вопрос знатокам, как можно описать все вариации ошибок?