Hướng dẫn sử dụng Postman để kiểm tra API cho người mới bắt đầu

Postman là gì?

Postman là một công cụ mạnh mẽ giúp lập trình viên kiểm tra (test) và phát triển API một cách trực quan. Thay vì phải viết code phức tạp để gửi request, bạn có thể dùng Postman để gửi GET, POST, PUT, DELETE chỉ với vài cú click chuột.

Đây là công cụ không thể thiếu cho bất kỳ ai làm việc với web, mobile app hay microservices.

1. Cài đặt Postman

Bước 1: Truy cập postman.com/downloads và tải bản phù hợp với hệ điều hành của bạn (Windows, macOS, Linux).

Bước 2: Cài đặt như phần mềm thông thường. Sau khi mở, bạn có thể dùng bản Free (đã đủ cho đa số nhu cầu).

Bước 3: Tạo tài khoản (miễn phí) hoặc dùng ngay mà không cần đăng nhập.

2. Giao diện chính của Postman

Khi mở Postman lần đầu, bạn sẽ thấy:

Sidebar (trái): Danh sách collections, requests đã lưu.
Request Tab (giữa): Khu vực soạn thảo và gửi request.
Response Panel (dưới): Hiển thị kết quả trả về từ server.
Top Bar: Thanh địa chỉ để nhập URL API và chọn method.

3. Hướng dẫn gửi request đầu tiên

Hãy thử gọi một API public để kiểm tra:

3.1. Gửi GET request

Nhập URL: https://jsonplaceholder.typicode.com/posts/1
Chọn method: GET
Nhấn nút Send màu xanh

Kết quả trả về sẽ là một JSON chứa thông tin bài viết:

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat...",
  "body": "quia et suscipit..."
}

3.2. Gửi POST request

Giữ nguyên URL: https://jsonplaceholder.typicode.com/posts
Chọn method: POST
Vào tab Body → chọn raw → chọn JSON

Nhập nội dung:

{
  "title": "Bài viết mới",
  "body": "Nội dung bài viết",
  "userId": 1
}

Nhấn Send

4. Collections - Nhóm request

Collection là tính năng giúp bạn nhóm các request lại với nhau để quản lý dự án dễ dàng hơn.

Click + New Collection ở sidebar
Đặt tên collection (VD: "API Shop", "User API")
Kéo thả request vào collection để sắp xếp

5. Environment - Biến môi trường

Postman cho phép bạn tạo biến môi trường để chuyển đổi giữa các môi trường (development, staging, production) dễ dàng.

Cách tạo:

Click biểu tượng Eye (góc phải trên) → Edit
Thêm biến: base_url = https://api.example.com
Trong request, dùng {{base_url}}/users thay vì URL cứng

6. Test scripts cơ bản

Postman có tab Tests cho phép viết JavaScript để kiểm tra kết quả tự động:

// Kiểm tra status code
pm.test("Status 200", function () {
    pm.response.to.have.status(200);
});

// Kiểm tra response time < 200ms
pm.test("Response time OK", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

// Kiểm tra JSON có field cần thiết
pm.test("Has id field", function () {
    const json = pm.response.json();
    pm.expect(json).to.have.property("id");
});

Chạy test: Gửi request → xuống tab Test Results để xem kết quả Pass/Fail.

7. Mẹo hay khi dùng Postman

Ctrl + S: Lưu request nhanh
History tab: Xem lại request đã gửi trong quá khứ
Code snippet: Click Code () để xem code tương ứng (cURL, Python, JavaScript,...)
Import/Export: Chia sẻ collection với team qua file JSON hoặc link
Runner: Chạy toàn bộ request trong collection để test hàng loạt

Kết luận

Postman là công cụ đơn giản nhưng cực kỳ hiệu quả cho việc kiểm tra và phát triển API. Dù bạn là lập trình viên mới hay đã có kinh nghiệm, Postman sẽ giúp bạn tiết kiệm thời gian và làm việc chuyên nghiệp hơn.

Bắt đầu ngay: Tải Postman miễn phí tại postman.com và thử nghiệm với API đầu tiên của bạn!

👉 Nếu bạn cần hỗ trợ về phát triển API hoặc thiết kế hệ thống backend, liên hệ ngay với FTECHX Solutions để được tư vấn giải pháp phù hợp!