Nếu bạn vẫn không sử dụng ngôn ngữ định nghĩa cho các thông số kỹ thuật API có thể đọc được bằng máy, chẳng hạn như OpenAPI (trước đây gọi là Swagger), bạn chắc chắn nên cân nhắc làm như vậy. Xét cho cùng, API là ngôn ngữ để các máy nói chuyện với nhau.
Swagger có phải là một ý tưởng hay không?
Swagger tạo ấn tượng ban đầu rất tốt Bên cạnh đó, nhiều người nghĩ rằng khả năng tạo mã từ tài liệu là một ý tưởng hay và Swagger cung cấp điều đó cũng. Vì vậy, thực tế là sự vênh vang tạo ấn tượng ban đầu tuyệt vời, làm cho những hạn chế và hạn chế của nó trở nên ít rõ ràng hơn.
Mục đích sử dụng Swagger là gì?
Swagger cho phép bạn mô tả cấu trúc của các API để máy móc có thể đọc chúng. Khả năng mô tả cấu trúc riêng của các API là gốc rễ của tất cả sự tuyệt vời trong Swagger.
Swagger còn được sử dụng không?
Ngày nay, nhiều người dùng vẫn sử dụng thuật ngữ " Swagger" để chỉ định dạng Đặc tả OpenAPI 2.0và "Swagger spec" để chỉ tài liệu mô tả API ở định dạng này. RepreZen API Studio sử dụng các thuật ngữ này trong một số phần của giao diện người dùng, nhưng đề cập đến OpenAPI 3.0 và các phiên bản mới hơn là "OpenAPI ".
Có phải chỉ dành cho API REST không?
Đặc điểm kỹ thuật OpenAPI (trước đây là Đặc điểm kỹ thuật Swagger) là một định dạng mô tả API cho các API REST. Tệp OpenAPI cho phép bạn mô tả toàn bộ API của mình, bao gồm: Các điểm cuối khả dụng (/ người dùng) và các hoạt động trên mỗi điểm cuối (GET / người dùng, POST / người dùng)
