Bộ kiểm thử / client REST API

Soạn và gửi yêu cầu HTTP với tham số truy vấn, header, thân JSON / form và xác thực Basic hoặc Bearer, rồi xem trạng thái, thời gian và phản hồi JSON đã định dạng. Nhập một lệnh cURL có sẵn hoặc sao chép yêu cầu hiện tại ra lại dạng cURL. Muốn dựng yêu cầu có thể tái sử dụng từng bước? Dùng Bộ dựng yêu cầu HTTP. Xem thêm họ Công cụ API.
Mọi thứ chạy cục bộ trong trình duyệt của bạn. Yêu cầu đa nguồn chịu chính sách CORS của máy chủ đích — xem ghi chú bên dưới nếu yêu cầu bị lỗi.
Dán một lệnh cURL
Tham số truy vấn
Header
Body
Authorization
Tùy chọn
Khi được điền, URL yêu cầu được nối vào tiền tố này. Hữu ích cho máy chủ bị chặn bởi CORS.
200
Thân Header

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Vì sao yêu cầu có thể thất bại: trình duyệt chặn đọc đa nguồn trừ khi API trả về Access-Control-Allow-Origin. Nếu đích không cho phép CORS, bạn có thể chạy proxy CORS của riêng mình và dán URL của nó vào ô tiền tố proxy ở trên, hoặc dùng Bộ chuyển đổi cURL để chạy yêu cầu từ terminal. Thân yêu cầu của GET/HEAD bị bỏ qua, và công cụ WebSocket nằm riêng tại Trình kiểm thử WebSocket.


                                                            

                                                                Giải thích các phương thức HTTP
                                                                
Phương thức bạn chọn cho máy chủ biết bạn muốn làm gì với URL. Đây là ý nghĩa của bảy động từ mà công cụ này có thể gửi:

                                                                
GET — Lấy một tài nguyên: một trang web, một ảnh, một danh sách bản ghi. “Cho tôi thứ đang ở URL này.” Chỉ đọc và an toàn khi lặp lại, và thường không mang thân yêu cầu (nếu có thân trên GET thì bị bỏ qua).

                                                                
POST — Gửi dữ liệu mới lên máy chủ, thường để tạo một tài nguyên hoặc kích hoạt một hành động — gửi form, tải tệp lên, khởi chạy một tác vụ. Nội dung đi trong thân yêu cầu. POST không lũy đẳng: gửi cùng một POST hai lần có thể tạo hai bản ghi.

                                                                
PUT — Thay thế toàn bộ tài nguyên tại URL bằng nội dung bạn gửi. Thân phải chứa phiên bản mới đầy đủ của tài nguyên. PUT là lũy đẳng: lặp lại cùng yêu cầu cho tác dụng giống như gửi một lần.

                                                                
PATCH — Chỉ thay đổi một phần tài nguyên. Bạn chỉ gửi các trường muốn cập nhật, ví dụ {"email": "new@example.com"}, thay vì toàn bộ bản ghi. Chọn PATCH khi một PUT đầy đủ sẽ buộc bạn gửi lại các trường mà bạn không đụng tới.

                                                                
DELETE — Xóa tài nguyên tại URL. DELETE là lũy đẳng: xóa một thứ đã không còn tồn tại sẽ cho cùng kết quả (thường là 404) và không làm gì thêm lần hai.

                                                                
HEAD — Giống hệt GET, nhưng phản hồi chỉ có header — không gửi lại thân nào. Dùng HEAD để kiểm tra một URL có tồn tại không, tệp lớn bao nhiêu (Content-Length), được sửa lần cuối khi nào (Last-Modified) hoặc thuộc loại gì (Content-Type), mà không phải tải toàn bộ nội dung.

                                                                
OPTIONS — Hỏi máy chủ những phương thức và tùy chọn nào được phép cho một URL, hoặc kích hoạt kiểm tra preflight CORS. Các header phản hồi, như Access-Control-Allow-Methods, liệt kê những gì được phép. OPTIONS thường không mang thân; trình duyệt thường tự gửi nó trước một POST/PUT/PATCH/DELETE đa nguồn.

                                                                
Dễ nhầm lẫn: HEAD so với GET — yêu cầu giống hệt nhau, nhưng HEAD không trả về thân. PUT so với PATCH — PUT thay thế toàn bộ tài nguyên; PATCH chỉ cập nhật từng phần các trường bạn gửi.