Công cụ kiểm thử API hướng dữ liệu bằng CSV hoặc JSON

Kiểm thử một điểm cuối API một lần thì khá đơn giản. Bạn gửi một yêu cầu, xem xét phản hồi và xác nhận mọi thứ hoạt động như mong đợi. Thử thách thực sự bắt đầu khi bạn cần chạy cùng một bài kiểm thử với hàng chục – hoặc thậm chí hàng trăm – bộ dữ liệu khác nhau. Việc cập nhật thủ công các tham số và gửi yêu cầu lặp đi lặp lại không chỉ tốn thời gian, dễ mắc lỗi mà còn không thể mở rộng.

Đây là lúc kiểm thử API dựa trên dữ liệu phát huy tác dụng. Thay vì viết lại hoặc gửi lại yêu cầu bằng tay, bạn định nghĩa một trường hợp kiểm thử duy nhất và chạy nó tự động với nhiều bộ dữ liệu đầu vào. Kết quả là phạm vi bao phủ rộng hơn, độ chính xác cao hơn và ít công sức thủ công hơn rất nhiều.

Để thực hiện điều này một cách hiệu quả, bạn cần công cụ phù hợp. Apidog nổi bật nhờ hỗ trợ gốc cho kiểm thử dựa trên dữ liệu bằng cách sử dụng các tệp CSV và JSON. Là một nền tảng phát triển và kiểm thử API tất cả trong một, Apidog cho phép bạn liên kết các tệp dữ liệu bên ngoài với một kịch bản kiểm thử và thực thi nó lặp đi lặp lại, tự động xác thực từng phản hồi.

Cho dù bạn đang kiểm thử luồng đăng nhập với nhiều người dùng khác nhau, API tìm kiếm với các truy vấn đa dạng, hay tạo tài nguyên với nhiều tổ hợp tham số, Apidog đều loại bỏ công việc lặp đi lặp lại và giúp bạn đạt được kiểm thử API đáng tin cậy, toàn diện chỉ trong một phần nhỏ thời gian.

nút

Bây giờ, chúng ta hãy cùng đi sâu vào hướng dẫn chi tiết, từng bước để thành thạo kiểm thử API dựa trên dữ liệu bằng Apidog với CSV và JSON.

Hướng dẫn từng bước về kiểm thử API dựa trên dữ liệu với CSV và JSON

Hãy cùng đi qua toàn bộ quy trình, từ thiết lập đến thực thi, sử dụng một ví dụ cụ thể. Chúng ta sẽ kiểm thử một điểm cuối API đăng ký người dùng.

Bước 1: Định nghĩa yêu cầu API cơ sở của bạn

Đầu tiên, bạn tạo yêu cầu API sẽ đóng vai trò là mẫu kiểm thử của bạn.

Trong Apidog, tạo một yêu cầu mới đến điểm cuối đăng ký người dùng của bạn (ví dụ: POST /api/v1/users).
Thiết lập các header (ví dụ: Content-Type: application/json).
Trong tab Body, tạo payload JSON của bạn. Thay vì mã hóa cứng các giá trị, bạn sẽ sử dụng cú pháp biến động của Apidog {{}} để tạo các giá trị giữ chỗ.

{
  "username": "{{username}}",
  "email": "{{email}}",
  "password": "{{password}}",
  "role": "{{role}}"
}

Lưu ý các giá trị giữ chỗ: {{username}}, {{email}}, v.v. Apidog sẽ thay thế chúng bằng các giá trị thực từ tệp dữ liệu của bạn trong quá trình thực thi.

Bước 2: Tạo tệp dữ liệu kiểm thử của bạn (CSV hoặc JSON)

Bây giờ, hãy tạo tệp bên ngoài sẽ cung cấp dữ liệu cho các giá trị giữ chỗ của bạn.

Tùy chọn A: Sử dụng tệp CSV

CSV lý tưởng cho dữ liệu dạng bảng. Tạo một tệp user_data.csv:

username,email,password,role,expected_status
john_doe,john@example.com,SecurePass123!,user,201
jane_smith,jane@example.com,AnotherPass456!,admin,201
bad_user,not-an-email,short,user,400
duplicate_user,john@example.com,SomePass789!,user,409

Dòng đầu tiên định nghĩa tên biến khớp với các giá trị giữ chỗ của bạn (username, email, v.v.), cộng thêm một expected_status bổ sung để xác thực.
Mỗi dòng tiếp theo là một trường hợp kiểm thử với dữ liệu cho lần chạy đó.

Tùy chọn B: Sử dụng tệp JSON

JSON lý tưởng cho các cấu trúc dữ liệu lồng nhau hoặc phức tạp hơn. Tạo một tệp user_data.json:

[
  {
    "username": "john_doe",
    "email": "john@example.com",
    "password": "SecurePass123!",
    "role": "user",
    "expected_status": 201
  },
  {
    "username": "jane_smith",
    "email": "jane@example.com",
    "password": "AnotherPass456!",
    "role": "admin",
    "expected_status": 201
  },
  {
    "username": "bad_user",
    "email": "not-an-email",
    "password": "short",
    "role": "user",
    "expected_status": 400
  }
]

Bước 3: Cấu hình kiểm thử dựa trên dữ liệu trong Apidog

Đây là lúc quy trình làm việc tích hợp của Apidog phát huy tác dụng.

Đi tới tab "Test" trong bảng điều khiển của bạn (hoặc tạo một trường hợp kiểm thử mới trong một bộ kiểm thử).

2. Nhấp để thêm một bước kiểm thử mới và chọn yêu cầu POST /api/v1/users của bạn.

3. Tải dữ liệu kiểm thử lên: Nhấp vào "Test Data" > "+New" để tải tệp user_data.csv hoặc user_data.json của bạn lên. Apidog sẽ phân tích cú pháp và hiển thị bản xem trước của các dòng dữ liệu.

giao diện nhập dữ liệu kiểm thử trong Apidog

nhập dữ liệu CSV hoặc JSON để kiểm thử API

4. Ánh xạ biến (nếu cần): Apidog tự động ánh xạ tên cột (CSV) hoặc khóa thuộc tính (JSON) tới các giá trị giữ chỗ {{variable}} trong yêu cầu của bạn. Xác minh rằng ánh xạ là chính xác.

Bước 4: Viết các khẳng định (Assertions) bằng cách sử dụng các biến dữ liệu của bạn

Sức mạnh thực sự đến từ việc xác thực các kết quả mong đợi khác nhau dựa trên dữ liệu đầu vào của bạn. Trong tab Test, bạn viết các khẳng định (assertions) (còn được gọi là "asserts" hoặc "checks").

Điều quan trọng là bạn có thể tham chiếu các biến dữ liệu tương tự từ tệp của mình trong các khẳng định.

Ví dụ, thêm một khẳng định Mã trạng thái phản hồi:

Giá trị mong đợi: {{expected_status}}

Điều này có nghĩa là: "Đối với lần chạy kiểm thử đầu tiên (john_doe), khẳng định mã trạng thái bằng 201. Đối với lần chạy thứ ba (bad_user), khẳng định nó bằng 400." Khẳng định sẽ thay đổi động với mỗi lần lặp.

Bạn có thể thêm các khẳng định phức tạp hơn bằng JavaScript trong phần Script của Apidog:

// Example: Validate response body for successful creation
pm.test("Status code is " + pm.variables.get("expected_status"), function () {
    pm.response.to.have.status(pm.variables.get("expected_status"));
});

// Only check for user ID if we expect a successful creation
if (pm.variables.get("expected_status") === 201) {
    pm.test("Response has user ID", function () {
        var jsonData = pm.response.json();
        pm.expect(jsonData.id).to.be.a('number');
        pm.expect(jsonData.username).to.eql(pm.variables.get("username"));
    });
}

Bước 5: Chạy kiểm thử và phân tích kết quả

Nhấp vào nút Run. Apidog sẽ thực thi bước kiểm thử duy nhất của bạn nhiều lần, mỗi lần cho mỗi dòng trong tệp dữ liệu của bạn.

Báo cáo là nơi mọi thứ được tổng hợp:

Apidog trình bày một báo cáo rõ ràng, tổng hợp, hiển thị:

Tổng số lần lặp: (ví dụ: "4/4 Passed")
Phân tích chi tiết cho từng dòng dữ liệu: Bạn có thể mở rộng để xem yêu cầu chính xác đã gửi (với các giá trị thay thế thực tế) và phản hồi nhận được cho lần lặp cụ thể đó.
Mọi lỗi đều được chỉ rõ đến dòng dữ liệu cụ thể gây ra sự cố. Liệu duplicate_user có thất bại vì trạng thái không phải là 409 không? Bạn sẽ thấy ngay lập tức.

Điều này giúp gỡ lỗi cực kỳ hiệu quả. Bạn không cần phải đoán trường hợp kiểm thử nào đã thất bại; bạn biết đó là lần lặp với bộ dữ liệu cụ thể {"username": "duplicate_user", ...}.

Các phương pháp hay nhất để kiểm thử API dựa trên dữ liệu

Dữ liệu dành riêng cho môi trường: Kết hợp kiểm thử dựa trên dữ liệu với Môi trường của Apidog. Bạn có thể có một biến base_url trong môi trường của mình thay đổi từ môi trường thử nghiệm sang môi trường sản xuất, trong khi tệp CSV của bạn chứa các trường hợp kiểm thử áp dụng cho cả hai.
Dữ liệu kiểm thử có thể tái sử dụng: Lưu trữ các tệp CSV/JSON của bạn ở một nơi trung tâm trong dự án Apidog của bạn. Nhiều bộ kiểm thử có thể tham chiếu cùng một tệp dữ liệu, đảm bảo tính nhất quán.
Tạo tệp dữ liệu bằng chương trình: Đối với các kịch bản phức tạp, hãy sử dụng một script (Python, Node.js) để tạo tệp test_data.csv của bạn. Điều này rất hữu ích để kiểm thử với dữ liệu ngẫu nhiên hoặc một phạm vi giá trị lớn (ví dụ: kiểm thử phân trang với 100 tổ hợp page và limit khác nhau).
Thiết lập/Dọn dẹp kiểm thử: Sử dụng các script trước yêu cầu và tính năng dọn dẹp kiểm thử của Apidog kết hợp với kiểm thử dựa trên dữ liệu. Ví dụ, trước mỗi lần lặp của một kiểm thử DELETE, bạn có thể sử dụng một script trước yêu cầu để tạo tài nguyên sẽ bị xóa.

Kết luận: Chuyển đổi quy trình kiểm thử API của bạn

Kiểm thử dựa trên dữ liệu trong Apidog với các tệp CSV/JSON giúp bạn chuyển từ kiểm tra thủ công, lặp đi lặp lại sang xác thực tự động, toàn diện. Nó thể hiện nguyên tắc cốt lõi của kiểm thử tốt: kỹ lưỡng mà không làm giảm hiệu quả.

Bằng cách ngoại hóa dữ liệu kiểm thử của mình, bạn tạo ra một tài liệu sống động về các kịch bản kiểm thử mà bất kỳ ai trong nhóm của bạn cũng có thể dễ dàng đọc, cập nhật và hiểu. Việc tích hợp liền mạch phương pháp này của Apidog có nghĩa là không cần thiết lập phức tạp – chỉ là một con đường thẳng đến các API đáng tin cậy hơn.

Hãy ngừng kiểm thử API từng trường hợp một. Tải Apidog miễn phí ngay hôm nay, nhập tệp CSV đầu tiên của bạn và trải nghiệm cách kiểm thử API có thể mạnh mẽ và hiệu quả đến mức nào.

nút