HƯỚNG DẪN KIỂM THỬ API CHI TIẾT BẰNG POSTMAN
PHẦN 2: HƯỚNG DẪN KIỂM THỬ API CHI TIẾT BẰNG POSTMAN
2.1. Postman là gì?
Postman là công cụ miễn phí mạnh nhất hiện nay để thiết kế, kiểm thử và document API.
2.2. Cài đặt Postman
- Truy cập: https://www.postman.com/downloads/
- Tải phiên bản phù hợp (Windows/Mac/Linux)
- Cài đặt và đăng ký tài khoản (khuyến khích dùng tài khoản để lưu Collection trên cloud)
2.3. Giao diện Postman cơ bản
2.4. Tạo và thực hiện Request cơ bản
Bước 1: Mở Postman → New → HTTP Request
Bước 2: Chọn phương thức (GET/POST…)
Bước 3: Nhập URL
Bước 4: Thêm Headers, Params, Body (nếu cần)
Bước 5: Nhấn Send
2.5. Ví dụ thực hành với JSONPlaceholder (API test miễn phí)
Base URL: https://jsonplaceholder.typicode.com
Ví dụ 1: GET – Lấy danh sách bài viết
- Method: GET
- URL: https://jsonplaceholder.typicode.com/posts
- Send → Kết quả: mảng JSON 100 bài viết
Ví dụ 2: GET – Lấy 1 bài viết theo ID
- URL: https://jsonplaceholder.typicode.com/posts/1
Ví dụ 3: POST – Tạo bài viết mới
- Method: POST
- URL: https://jsonplaceholder.typicode.com/posts
- Body → raw → JSON:
JSON
{
"title": "Bài viết của Dillon",
"body": "Nội dung test API",
"userId": 1
}
Ví dụ 4: PUT – Cập nhật bài viết
- Method: PUT
- URL: https://jsonplaceholder.typicode.com/posts/1
Ví dụ 5: DELETE
- Method: DELETE
- URL: https://jsonplaceholder.typicode.com/posts/1
2.6. Sử dụng Variables & Environments
- Tạo Environment: New → Environment → tên “Dev”
- Thêm biến: base_url = https://jsonplaceholder.typicode.com
- Trong request dùng: {{base_url}}/posts
2.7. Viết Test Scripts trong Postman (JavaScript)
Trong tab Tests của request, viết:
JavaScript
pm.test("Status code is 200", () => {
pm.response.to.have.status(200);
});
pm.test("Response time is less than 500ms", () => {
pm.expect(pm.response.responseTime).to.be.below(500);
});
const jsonData = pm.response.json();
pm.test("Title có trong response", () => {
pm.expect(jsonData.title).to.be.not.empty;
});
2.8. Collection Runner (chạy hàng loạt test)
- Right-click Collection → Run collection
- Chọn Environment → Run
- Xem báo cáo chi tiết
2.9. Công cụ khác để test API
- cURL (dùng trong terminal)
- Insomnia
- Thunder Client (extension VS Code)
- Newman (chạy Postman collection từ command line)
Ví dụ cURL đơn giản:
Bash
curl -X GET https://jsonplaceholder.typicode.com/posts