openapi automation - yibinericxia/documents GitHub Wiki

Its specification can be of JSON or YAML.

• Metadata

** info

** servers

** externalDocs

• paths contains endpoints with request and response models

• components reusable components for request and response models, security schemes, etc.

• security global definition for authentication and authorization

• tags global definition to group endpoints

• Design first

• Code first