Bộ dựng yêu cầu HTTP

Soạn một yêu cầu HTTP từng bước — các biến đường dẫn như {userId}, tham số truy vấn, header, body JSON / form và xác thực — rồi tạo mã sẵn sàng chạy cho cURL, Node.js fetch, Python requests hoặc PowerShell. Công cụ này dùng để thiết kế và tạo mã; để thực sự gửi yêu cầu và xem phản hồi trực tiếp, hãy chuyển yêu cầu sang bằng nút Thử yêu cầu → (mở REST API Client / Tester), hoặc chuyển đổi cURL đã dán bằng Bộ chuyển đổi lệnh cURL.
Mọi thứ được lắp ráp cục bộ trong trình duyệt của bạn. Không có yêu cầu nào được gửi từ trang này.
Tham số đường dẫn (các token {name} trong URL ở trên)
Tham số truy vấn
Header
Body
Authorization
Xem trước cURL trực tiếp — cập nhật khi bạn gõ:
cURL Node.js fetch Python requests PowerShell
Mẹo: bọc một đoạn URL trong dấu ngoặc nhọn ({userId}) để quản lý nó như tham số đường dẫn; mã được tạo được làm mới sau mỗi lần sửa. Yêu cầu GET/HEAD bỏ qua body. Tải tệp lên được tạo dùng kiểu @file của cURL hoặc placeholder ở các ngôn ngữ khác — hãy đính kèm tệp thật trong mã của bạn. Việc gửi xuyên nguồn gốc được đề cập trong REST API Client (tôn trọng chính sách CORS của server); để đảo ngược một lệnh có sẵn, dùng Bộ chuyển đổi lệnh cURL.
Giải thích các phương thức HTTP
Khi bạn chọn một phương thức, mã cURL / Node / Python / PowerShell được tạo sẽ thay đổi cho khớp. Dưới đây là ý nghĩa của từng động từ đối với yêu cầu bạn đang soạn:
GET — Lấy một biểu diễn của tài nguyên. Không nên thay đổi trạng thái server, và yêu cầu được tạo thường không có body. Dùng GET để đọc, tìm kiếm và các endpoint danh sách.
POST — Gửi dữ liệu để tạo tài nguyên mới hoặc kích hoạt một hành động. Body trở thành payload trong mã được tạo (--data-raw trong cURL, một đối số body trong Node/Python, v.v.). POST không lũy đẳng: gửi hai lần có thể tạo hai tài nguyên.
PUT — Thay thế hoàn toàn một tài nguyên đã có. Gửi toàn bộ đối tượng trong body; các trường bị bỏ qua có thể được coi là trống. Mã được tạo gửi toàn bộ body tới đúng URL.
PATCH — Chỉ cập nhật các trường bạn đưa vào. Body mang một tập thay đổi một phần, nên các yêu cầu được tạo nhỏ hơn PUT khi bạn chỉ sửa một hai giá trị.
DELETE — Xóa tài nguyên tại URL. Thao tác này lũy đẳng (idempotent) và thường không có body, nên mã được tạo là một lệnh xóa đơn giản chỉ có header.
HEAD — Chỉ yêu cầu header, không có body phản hồi. Mã được tạo trông giống GET nhưng trả về siêu dữ liệu như Content-Length, Last-Modified hoặc Content-Type, tiết kiệm băng thông.
OPTIONS — Khám phá những gì server cho phép ở một URL, hoặc mô phỏng preflight CORS. Các header phản hồi (ví dụ Access-Control-Allow-Methods) cho thấy động từ nào được phép. OPTIONS thường không có body yêu cầu.
Dễ nhầm: HEAD so với GET — các yêu cầu được tạo khá giống nhau, nhưng HEAD không trả về body. PUT so với PATCH — PUT ghi đè toàn bộ tài nguyên; PATCH chỉ thay đổi các trường bạn cung cấp.