Как определить в OpenAPI / Swagger, является ли поле необязательным или обязательным, а какое - по умолчанию?
Как указать, является ли поле необязательным или обязательным в OpenAPI / Swagger?
Ответы (3)
По умолчанию поля в модели являются необязательными, если вы не помещаете их в список required
. Ниже приведен пример - id
, category
- необязательные поля, name
является обязательным. Обратите внимание, что required
- это не атрибут полей, а атрибут самого объекта - это список обязательных свойств.
type: object
required: # List the required properties here
- name
properties:
id:
type: integer
format: int64
category:
$ref: '#/definitions/Category'
name:
type: string
example: doggie
Если это модель тела запроса, вам, вероятно, также потребуется пометить само тело как required
:
# swagger: '2.0'
parameters:
- in: body
name: body
required: true # <----
schema:
$ref: '#/definitions/Pet'
# openapi: 3.0.1
requestBody:
required: true # <----
content:
...
Чтобы указать значение по умолчанию для необязательных полей, вы можете использовать атрибут default
. Вот пример:
type: object
properties:
huntingSkill:
type: string
description: The measured skill for hunting
default: lazy
person
William Cheng
schedule
18.10.2016
Поля являются необязательными, если они не отмечены как обязательные.
Вы перечисляете обязательные поля следующим образом:
SomeObject:
type: object
required:
- name
- fartingPower
properties:
name:
type: string
fartingPower:
type: integer
person
Bohdan
schedule
13.08.2018
пердеж: только сила заслуживает +1
- person MariusJP; 19.08.2019
Альтернативный синтаксис:
Response:
type: object
required: [id, title]
properties:
id:
type: string
title:
type: string
person
Graham
schedule
16.04.2021