Open API Spec
OpenAPI Specification (OAS), | formerly Swagger, is a | standard for defining and | documenting RESTful APIs | in YAML/JSON format.
Đặc tả OpenAPI (OAS), | trước đây là Swagger, là một | tiêu chuẩn để định nghĩa và | lập tài liệu cho các API RESTful | ở định dạng YAML/JSON.
Describes endpoints, formats, | authentication, and metadata.
Mô tả các điểm cuối, định dạng, | xác thực và siêu dữ liệu.
Enables client generation, | automated documentation, testing, | and promotes API | design consistency.
Cho phép tạo máy khách, | lập tài liệu tự động, kiểm thử, | và thúc đẩy tính nhất quán | trong thiết kế API.
Resources
- OpenAPI Specification Website (official)
- Open API Live Editor (official)
- OpenAPI 3.0: How to Design and Document APIs with the Latest OpenAPI Specification 3.0 (video)
- REST API and OpenAPI: It’s Not an Either/Or Question (video)
References
- https://roadmap.sh/backend (Node: [label])