Swagger là gì? Tại sao chúng ta nên sử dụng swagger?

• Bài viết này mình sẽ giới thiệu đến mọi người một công cụ có tên là Swagger
• Swagger là gì?
•  Swagger là một phần mềm mã nguồn mở được sử dụng để phát triển thiết kế và làm các document cho các REST API và còn có một số tính năng khác các bạn có thể vào link sau để xem https://swagger.io/docs/specification/2-0/what-is-swagger/
• Có một số phần mềm swagger như Swagger Editor, Swagger Codegen, Swagger Inspector, Swagger UI. Trong đó swagger UI được sử dụng nhiều nhất
• Vậy  tại sao ta nên dùng Swagger? Swagger sẽ hỗ trợ các annoutation giúp cho ứng dụng spring của ta có thể mô tả đươc các restapi, và đồng thơi build một giao diện giúp người dùng có thể tương tác trực tiếp với các rest api đó.
• Ví dụ về Swagger:
• Để hiểu rõ hơn về swagger các bạn truy cập đường link sau để hiểu hơn http://petstore.swagger.io/
• Sau khi bạn truy cập vào trang web bạn có thể thấy được đang có những api nào trong ứng dụng này và cả những method tương ứng của nó

• Và đối với mỗi api chúng ta có thể biết được input và output của chúng cũng như những status có thể trả về của api này

• Ở trên là ví dụ sơ qua của mình về swagger các bạn có thể truy cập vào trang web trên để tự mình trải nghiệm. Ở bài viết sau mình sẽ hướng dẫn các bạn cách tích hợp swagger này vào trong ứng dụng Spring Boot

Author: Nguyễn Minh Quân

Đăng ký nhận bộ tài liệu kỹ năng dành cho lập trình viên (video hướng dẫn + slide) tại đây

Hướng dẫn cách tích hợp Swagger vào trong ứng dụng Spring Boot tại đây

>> Xem ngay Devworld – Cẩm nang giúp lập trình viên phát triển bền vững với nghề lập trình