DEV Community

Do Van Phuc
Do Van Phuc

Posted on

RESTful API

  • API (Application Programming Interface): Là tập hợp các quy tắc và cơ chế cho phép các thành phần phần mềm giao tiếp với nhau. API thường trả về dữ liệu dưới dạng JSON hoặc XML.
  • REST (REpresentational State Transfer): Là một kiểu kiến trúc để thiết kế API, sử dụng các phương thức HTTP như GET, POST, DELETE,... để giao tiếp giữa các máy tính. REST cho phép sử dụng URL để xử lý và chuyển đổi dữ liệu.
  • RESTful API: Là tiêu chuẩn thiết kế API dựa trên kiến trúc REST. RESTful API được sử dụng rộng rãi cho các ứng dụng web, di động để quản lý và giao tiếp với các tài nguyên (resources).

Các phương thức HTTP phổ biến

GET

  • Phương thức GET được sử dụng để yêu cầu dữ liệu từ một tài nguyên trên máy chủ. Phương thức này có tính bất biến nên có thể gọi nhiều lần mà vẫn ra cùng 1 kết quả cho đến khi một phương thức khác làm thay đổi tài nguyên. Không có body.
  • Sử dụng khi muốn lấy dữ liệu mà không thay đổi trạng thái của tài nguyên. Ví dụ lấy dữ liệu để hiển thị ra màn hình.

POST

  • Phương thức POST được sử dụng để gửi dữ liệu đến máy chủ để tạo một tài nguyên mới. POST không có tính bất biến vì vậy khi gửi 2 yêu cầu giống hệt nhau sẽ tạo ra 2 tài nguyên khác nhau, cùng dữ liệu (trừ ID). Có body.
  • Sử dụng khi muốn tạo mới một tài nguyên. Ví dụ dùng để tạo tài khoản cho người dùng, tạo sản phẩm mới,...

PUT

  • Phương thức PUT được sử dụng để cập nhật toàn bộ thông tin của tài nguyên hiện có trên máy chủ. Có body.
  • Sử dụng khi muốn cập nhật toàn bộ thông tin của một tài nguyên.

PATCH

  • Phương thức PATCH được sử dụng để cập nhật một phần thông tin của tài nguyên hiện có trên máy chủ. Có body.
  • Sử dụng khi muốn cập nhật một phần cụ thể của tài nguyên.

DELETE

  • Phương thức DELETE được sử dụng để xóa một tài nguyên khỏi máy chủ.
  • Sử dụng khi muốn xóa một tài nguyên. Không có body.

OPTIONS

  • Phương thức OPTIONS được sử dụng để mô tả các tùy chọn giao tiếp cho tài nguyên mục tiêu. Nó trả về các phương thức HTTP mà máy chủ hỗ trợ cho URL cụ thể đó. Không có body.
  • Sử dụng khi muốn kiểm tra các phương thức HTTP được phép sử dụng cho một tài nguyên hoặc kiểm tra cấu hình của máy chủ mà không thực hiện bất kỳ hành động cụ thể nào.

Trong RESTful APIs, "body" là phần dữ liệu được gửi kèm với yêu cầu hoặc phản hồi HTTP. Body có thể chứa bất kỳ dữ liệu nào mà máy chủ hoặc máy khách muốn truyền tải.
Các phương thức GET và DELETE thường không có body, vì GET chỉ yêu cầu dữ liệu từ máy chủ và DELETE chỉ yêu cầu xóa một tài nguyên cụ thể. Phương thức POST, PUT và PATCH thường có body để truyền tải thông tin dữ liệu cần thiết cho máy chủ xử lý.

Top comments (0)