Я хочу создать схему YAML для службы REST POST.
requestBody:
description: Details of the request
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCompanyRequest'
components:
schemas:
CreateCompanyRequest:
description: The requested data to the service.
type: object
required:
- address
- identifier
- type
А как указать, что поле identifier обязательно, только если type значение поля = "БОЛЬШОЙ"?
Или, может быть, поле identifier не должно быть в требуемом списке, вместо этого я должен добавить где-нибудь комментарии, чтобы третьи лица узнали о требованиях API?