Tweet
Các HTTP Method trong RESTful API
🔸 Các HTTP Method trong RESTful API
Trong RESTful API, mỗi hành động mà client muốn thực hiện lên tài nguyên (resource) trên server đều được xác định thông qua các HTTP Method. Dưới đây là mô tả chi tiết từng phương thức, hoàn toàn không dùng bảng:
1. GET – Lấy dữ liệu từ server
Phương thức GET được dùng để yêu cầu server trả về dữ liệu mà không làm thay đổi trạng thái của hệ thống.
GET được xem là an toàn (safe) và idempotent – nghĩa là bạn gọi GET bao nhiêu lần thì kết quả cũng như nhau.
Ví dụ thực tế: lấy danh sách người dùng, lấy trạng thái thiết bị, đọc dữ liệu cảm biến.
2. POST – Gửi dữ liệu lên server để tạo mới
POST cho phép client gửi dữ liệu lên server nhằm tạo ra một tài nguyên mới.
Dữ liệu được đặt trong phần body của HTTP request.
Phương thức này không idempotent, vì gọi POST nhiều lần có thể tạo ra nhiều bản ghi mới.
Ví dụ: tạo user mới, tạo đơn hàng mới, ghi log mới vào hệ thống.
3. PUT – Cập nhật hoặc tạo mới một tài nguyên
PUT được dùng để cập nhật toàn bộ một tài nguyên đã tồn tại.
Nếu tài nguyên chưa tồn tại, nhiều API cho phép PUT tự động tạo mới.
PUT là idempotent, nghĩa là chạy lại nhiều lần cũng chỉ cho ra một kết quả duy nhất.
Ví dụ: cập nhật cấu hình toàn bộ cho một thiết bị mạng.
4. DELETE – Xóa tài nguyên
DELETE được dùng để xóa tài nguyên trên server.
Cũng giống PUT, DELETE là idempotent – vì xóa nhiều lần liên tiếp cũng không làm thay đổi kết quả sau lần đầu.
Ví dụ: xóa user, xóa file log, xóa cấu hình interace.
5. HEAD – Kiểm tra thông tin tài nguyên (không lấy dữ liệu)
HEAD gần giống GET, nhưng chỉ trả về header mà không trả về body.
Dùng khi cần kiểm tra xem:
OPTIONS được dùng để hỏi server xem endpoint đó chấp nhận những HTTP Method nào.
OPTIONS rất quan trọng trong CORS, khi trình duyệt cần xác thực xem client web có được phép truy cập API hay không.
Ví dụ: trình duyệt tự gửi OPTIONS trước POST để xác nhận quyền truy cập.
7. TRACE – Kiểm tra đường đi của request
TRACE trả lại request như một “vết dò” để kỹ sư kiểm tra xem gói tin đã đi qua những thiết bị nào.
Ngày nay TRACE ít dùng vì lý do bảo mật, nhưng vẫn là một phần của chuẩn HTTP.
📌 Tóm tắt theo cách dễ nhớ
👉 Hãy tham gia khóa “CCNA Automation” tại VnPro, đăng ký ngay để nhận ưu đãi học phí đặc biệt!
vnpro #RESTAPI #HTTP python automation #CiscoDevNet #VnProTraining
Trong RESTful API, mỗi hành động mà client muốn thực hiện lên tài nguyên (resource) trên server đều được xác định thông qua các HTTP Method. Dưới đây là mô tả chi tiết từng phương thức, hoàn toàn không dùng bảng:
1. GET – Lấy dữ liệu từ server
Phương thức GET được dùng để yêu cầu server trả về dữ liệu mà không làm thay đổi trạng thái của hệ thống.
GET được xem là an toàn (safe) và idempotent – nghĩa là bạn gọi GET bao nhiêu lần thì kết quả cũng như nhau.
Ví dụ thực tế: lấy danh sách người dùng, lấy trạng thái thiết bị, đọc dữ liệu cảm biến.
2. POST – Gửi dữ liệu lên server để tạo mới
POST cho phép client gửi dữ liệu lên server nhằm tạo ra một tài nguyên mới.
Dữ liệu được đặt trong phần body của HTTP request.
Phương thức này không idempotent, vì gọi POST nhiều lần có thể tạo ra nhiều bản ghi mới.
Ví dụ: tạo user mới, tạo đơn hàng mới, ghi log mới vào hệ thống.
3. PUT – Cập nhật hoặc tạo mới một tài nguyên
PUT được dùng để cập nhật toàn bộ một tài nguyên đã tồn tại.
Nếu tài nguyên chưa tồn tại, nhiều API cho phép PUT tự động tạo mới.
PUT là idempotent, nghĩa là chạy lại nhiều lần cũng chỉ cho ra một kết quả duy nhất.
Ví dụ: cập nhật cấu hình toàn bộ cho một thiết bị mạng.
4. DELETE – Xóa tài nguyên
DELETE được dùng để xóa tài nguyên trên server.
Cũng giống PUT, DELETE là idempotent – vì xóa nhiều lần liên tiếp cũng không làm thay đổi kết quả sau lần đầu.
Ví dụ: xóa user, xóa file log, xóa cấu hình interace.
5. HEAD – Kiểm tra thông tin tài nguyên (không lấy dữ liệu)
HEAD gần giống GET, nhưng chỉ trả về header mà không trả về body.
Dùng khi cần kiểm tra xem:
- tài nguyên có tồn tại không,
- định dạng nội dung là gì,
- thời gian cập nhật gần nhất.
Ví dụ: kiểm tra file có tồn tại trên server trước khi tải về.
OPTIONS được dùng để hỏi server xem endpoint đó chấp nhận những HTTP Method nào.
OPTIONS rất quan trọng trong CORS, khi trình duyệt cần xác thực xem client web có được phép truy cập API hay không.
Ví dụ: trình duyệt tự gửi OPTIONS trước POST để xác nhận quyền truy cập.
7. TRACE – Kiểm tra đường đi của request
TRACE trả lại request như một “vết dò” để kỹ sư kiểm tra xem gói tin đã đi qua những thiết bị nào.
Ngày nay TRACE ít dùng vì lý do bảo mật, nhưng vẫn là một phần của chuẩn HTTP.
📌 Tóm tắt theo cách dễ nhớ
- GET → Đọc
- POST → Tạo
- PUT → Cập nhật
- DELETE → Xóa
- HEAD → Kiểm tra metadata
- OPTIONS → Xem server hỗ trợ gì
- TRACE → Chẩn đoán
👉 Hãy tham gia khóa “CCNA Automation” tại VnPro, đăng ký ngay để nhận ưu đãi học phí đặc biệt!
vnpro #RESTAPI #HTTP python automation #CiscoDevNet #VnProTraining