Здравствуйте!
OpenAPI — это вот это —
https://spec.openapis.org/oas/v3.1.0
Swagger — раньше оно всё так называлось, а теперь swagger'ом называют инструментарий для обработки OpenAPI спек.
Меня интересует раздел component/schemas —
https://spec.openapis.org/oas/v3.1.0#schema-object
В разделе "4.8.24.2 Fixed Fields" есть несколько полей, но в том API, YAML которого у меня есть, их нет, но там есть куча других.
В разделах "4.8.24 Schema Object" и "4.8.24.1 Properties" есть несколько ссылок, я там полазал, но не нашел описания того, что я вижу в своём ямле.
У меня что-то такое:
| Скрытый текст |
| components:
securitySchemes:
sso_auth:
type: http
scheme: bearer
schemas:
Empty:
type: object
required:
— trackingId
— payload
— status
properties:
trackingId:
type: string
payload:
type: object
status:
type: string
default: Ok
Error:
type: object
required:
— trackingId
— payload
— status
properties:
trackingId:
type: string
status:
type: string
default: Error
payload:
type: object
properties:
message:
type: string
code:
type: string
|
| |
По типам в спеке есть раздел —
https://spec.openapis.org/oas/v3.1.0#data-types
А вот по остальным полям — ничего
Я вообще в этой теме новичек. Подскажите, где чего внятное искать?
ЗЫ Это вроде про REST — т.е. web. Если в другой раздел писать, то куда?