Cách dùng Kiểm thử API
- Chọn phương thức và dán URL endpoint. Tham số truy vấn trong URL sẽ hiện ở tab Params, và chỉnh sửa tại đó sẽ cập nhật URL.
- Thêm header cho request. Nếu API yêu cầu, chọn Auth để dùng Bearer token hoặc thông tin Basic.
- Với POST, PUT hoặc PATCH, mở Body và chọn JSON, raw text hoặc các trường form. JSON được kiểm tra cú pháp khi bạn gõ; nhấn Format để định dạng lại cho dễ đọc.
- Nhấn Send (Ctrl+Enter). Xem trạng thái, thời gian, dung lượng, nội dung đã định dạng và response headers.
- Nhấn Copy as cURL để tái tạo request trong terminal hoặc gửi cho đồng nghiệp. Các request gần đây được lưu trong Lịch sử.
API tester là gì?
API tester (hay REST client) cho phép bạn gửi HTTP request tới một web service và xem chính xác những gì được trả về — không cần viết code. Lập trình viên dùng công cụ này để khám phá API bên thứ ba, debug webhook, kiểm tra xác thực, tái hiện lỗi được báo cáo và xác minh một endpoint trước khi tích hợp vào frontend. Công cụ này đáp ứng các nhu cầu thường ngày của những ứng dụng desktop như Postman hay Insomnia, không cần cài đặt và không cần tài khoản.
Cấu trúc của một HTTP request
- Method — hành động bạn muốn thực hiện:
GETđọc dữ liệu,POSTtạo mới,PUTthay thế,PATCHcập nhật một phần,DELETExóa.HEADchỉ trả về header,OPTIONShỏi các method nào được phép. - URL & query parameters — ví dụ
/v1/users?page=2&limit=50. Giá trị sẽ được mã hóa URL tự động khi bạn chỉnh sửa trong bảng Params. - Headers — thông tin đi kèm như
Accept: application/json,Content-Typehoặc header chứa API key. - Body — dữ liệu gửi đi với POST/PUT/PATCH. Body JSON được gửi với
Content-Type: application/json; body dạng form dùngapplication/x-www-form-urlencoded. - Auth — Bearer gửi
Authorization: Bearer <token>(OAuth 2.0, JWT). Basic gửiAuthorization: Basic base64(user:password).
Đọc phản hồi
Mã trạng thái cho biết kết quả: 2xx là thành công, 3xx là chuyển hướng, 4xx là lỗi từ request của bạn (401 thiếu xác thực, 404 sai đường dẫn, 422 lỗi validation), 5xx là lỗi phía máy chủ. Tra cứu từng mã trong tài liệu HTTP Status Codes của chúng tôi. Thời gian phản hồi được đo từ máy chủ của chúng tôi tới API, còn dung lượng là kích thước body tính bằng byte. Hãy xem content-type, các header giới hạn tần suất (x-ratelimit-remaining, retry-after) và header cache ở tab Headers.
Vì sao request đi qua máy chủ của chúng tôi
Trình duyệt chặn request cross-origin trừ khi API trả về header CORS, mà phần lớn API giao tiếp server-to-server không làm điều đó. Gửi request từ máy chủ của chúng tôi giúp tránh hoàn toàn CORS, nên bạn thấy đúng phản hồi thật của API. Để an toàn, request tới localhost, dải IP nội bộ và địa chỉ metadata của cloud đều bị chặn; nếu muốn test API cục bộ, hãy dùng curl — nút Copy as cURL sẽ tạo lệnh cho bạn, và công cụ cURL to Code của chúng tôi có thể chuyển lệnh đó sang JavaScript, Python hoặc PHP.
Có an toàn khi dùng thông tin xác thực thật không?
Request của bạn chỉ đi qua máy chủ của chúng tôi để chuyển tiếp; nó không được ghi log hay lưu trữ. Lịch sử được giữ trong trình duyệt của bạn và loại trừ các header Authorization, Cookie và API key. Dù vậy, với bất kỳ công cụ online nào, hãy ưu tiên test key hoặc token có thời hạn ngắn, và giải mã JWT ngay trên máy bằng JWT Decoder.
Cũng được tìm dưới tên: rest client online, postman online, gửi http request, test api online, http client, curl online, kiểm tra api, công cụ test api.
Các công cụ dùng kèm tốt với Kiểm thử API
- Tạo & Kiểm tra CORS Header — Đang gặp “has been blocked by CORS policy”?
- Kiểm tra OpenAPI / Swagger — Dán đặc tả API vào để kiểm tra theo schema OpenAPI chính thức, phát hiện tham chiếu hỏng và tham số path không nhất quán, đồng thời xem toàn bộ endpoint chỉ trong một cái nhìn.
- Webhook Tester — Lấy một URL riêng, gửi webhook hoặc HTTP client của bạn tới đó và xem request đổ về ngay lập tức — header, query string và body đã được định dạng, cùng với kiểm tra chữ ký HMAC.
- Định dạng JSON — Dán JSON để định dạng đẹp, nén hoặc kiểm tra.
Câu hỏi thường gặp
Có thể dùng làm API checker không?
Đây có phải là một lựa chọn Postman miễn phí không?
Vì sao tôi không gọi được localhost hoặc 192.168.x.x?
Tôi có gặp lỗi CORS không?
Có tự động theo redirect không?
Location, thường là điều bạn cần khi debug. Hãy gửi thêm một request tới URL mới nếu muốn theo chuyển hướng.