Nhảy đến nội dung chính

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

  1. Truy cập: https://www.postman.com/downloads/
  2. Tải phiên bản phù hợp (Windows/Mac/Linux)
  3. 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

  • Sidebar: Collections, Environments, History…
  • Workspace: nơi soạn request
  • Response: khu vực hiển thị kết quả

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