Я документирую свою конечную точку с помощью Open Api 3.0.2 и создаю интерфейс пользовательского интерфейса swagger из файла yaml. Моя служба принимает ответ мыла и генерирует ответ json. Однако элементы ответа мыла являются необязательными.
JSON генерируется на основе существующих элементов в ответе мыла. Есть ли способ пометить некоторые значения как необязательные? Я думал о свойстве anyOf, но оно не работает на уровне компонентов yaml (по крайней мере, я не смог заставить его работать). Возьмите приведенный ниже пример, скажем, ответ json может иметь все эти свойства, но может иметь только некоторые из них. Могу ли я сделать это более понятным в моем yaml?
openapi: 3.0.0
...
paths:
/path:
get:
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/Product'
components:
schemas:
Product:
type: object
properties:
productid:
type: string
origin:
type: string
shortname:
type: string
names:
type: array
items:
type: string
price:
type: string
shipping:
type: string
required
. - person Helen   schedule 12.03.2019