Talend API Tester là một tiện ích mở rộng của Chrome để gửi các yêu cầu HTTP và kiểm tra phản hồi mà không cần rời khỏi trình duyệt của bạn. Trước đây nó được gọi là Restlet Client, và nhiều nhà phát triển vẫn cài đặt nó để kiểm tra nhanh vì không cần tải xuống gì thêm ngoài chính tiện ích mở rộng đó. Nó xử lý các API REST, hỗ trợ các phương thức HTTP phổ biến và có thể xâu chuỗi các yêu cầu thành các kịch bản (scenarios).
Hướng dẫn này chỉ ra cách sử dụng Talend API Tester cho công việc kiểm thử thực tế. Bạn sẽ cài đặt nó, gửi yêu cầu đầu tiên của mình, sắp xếp các yêu cầu vào các dự án và dịch vụ, xây dựng một kịch bản chạy nhiều yêu cầu theo trình tự, và thêm các xác nhận (assertions) để công cụ tự kiểm tra phản hồi thay vì bạn phải tự mình xem xét. Các ví dụ sử dụng API công khai để bạn có thể làm theo ngay lập tức.
Cài đặt tiện ích mở rộng và gửi yêu cầu
Talend API Tester có mặt trên Chrome Web Store. Tìm kiếm “Talend API Tester” và nhấp vào Thêm vào Chrome. Nó cũng chạy trên các trình duyệt dựa trên Chromium như Edge và Brave. Sau khi cài đặt, hãy mở nó từ menu tiện ích mở rộng hoặc ghim nó vào thanh công cụ để truy cập nhanh.
Giao diện có một thanh bên ở bên trái và một bảng yêu cầu ở bên phải. Nhấp vào bảng yêu cầu và bạn sẽ thấy một danh sách thả xuống phương thức, một trường URL và các tab cho tiêu đề (headers) và nội dung (body).
Để gửi một yêu cầu cơ bản, chọn GET và nhập một endpoint thực tế. Dịch vụ JSONPlaceholder hoạt động tốt để thực hành:
GET https://jsonplaceholder.typicode.com/users/1
Nhấp vào Gửi. Phản hồi xuất hiện bên dưới với mã trạng thái, thời gian phản hồi, tiêu đề và nội dung. Talend API Tester định dạng JSON và XML một cách đẹp mắt (pretty-prints), vì vậy một phản hồi lồng nhau vẫn có thể đọc được mà không cần các bước bổ sung.
Đối với yêu cầu POST, hãy thay đổi phương thức, mở phần Nội dung (Body) và chọn loại nội dung. Chọn application/json và nhập một payload:
{
"name": "Priya Nair",
"email": "priya.nair@example.com"
}
Thêm tiêu đề vào phần Tiêu đề (Headers). Đối với API đã xác thực, hãy thêm tiêu đề Authorization với mã token của bạn. Công cụ này cũng có các trình hỗ trợ xác thực tích hợp cho các lược đồ Basic, Digest, OAuth và Bearer nếu bạn muốn không phải tự đặt tiêu đề.
Tổ chức các yêu cầu vào các dự án và dịch vụ
Một vài yêu cầu rời rạc là ổn cho việc kiểm tra nhanh một API. Khi bạn có nhiều yêu cầu, bạn sẽ muốn có cấu trúc. Talend API Tester sắp xếp công việc thành các dự án (projects), và bên trong một dự án thành các dịch vụ (services).
Tạo một dự án từ thanh bên và đặt cho nó một cái tên rõ ràng như “User API.” Bên trong đó, tạo các dịch vụ nhóm các endpoint liên quan, ví dụ: dịch vụ “Users” và dịch vụ “Orders.” Lưu mỗi yêu cầu vào đúng dịch vụ. Một dịch vụ có thể chứa một URL cơ sở, vì vậy các yêu cầu riêng lẻ bên dưới nó chỉ cần đường dẫn, điều này giúp mọi thứ gọn gàng.
Cấu trúc này quan trọng vì hai lý do. Thứ nhất, nó giúp một tập hợp lớn các yêu cầu dễ điều hướng, vì vậy bạn không phải cuộn qua hàng tá các cuộc gọi không được gắn nhãn để tìm cái bạn muốn. Thứ hai, nó là nền tảng cho các kịch bản (scenarios), mà chúng ta sẽ đề cập tiếp theo, vì một kịch bản tham chiếu các yêu cầu đã lưu.
Các dự án cũng giúp chuyển đổi môi trường. Talend API Tester hỗ trợ các biến môi trường, vì vậy bạn có thể định nghĩa một biến host chứa URL staging của bạn và tham chiếu nó trong mọi yêu cầu trong một dự án bằng một placeholder. Định nghĩa môi trường thứ hai với host sản phẩm, chuyển đổi giữa chúng, và toàn bộ dự án sẽ được định lại mục tiêu ngay lập tức. Điều này giúp bạn không phải chỉnh sửa URL bằng tay và tránh vô tình gửi một yêu cầu phá hoại đến sai máy chủ.
Talend API Tester cũng có thể nhập công việc hiện có. Nó chấp nhận các bộ sưu tập Postman, định nghĩa Swagger và OpenAPI, và các tệp HAR. Nếu bạn đã có một đặc tả API hoặc một bản xuất từ Postman, hãy nhập nó thay vì tạo lại mọi yêu cầu bằng tay. Để có một cách tiếp cận có cấu trúc để nhóm các kiểm tra, hướng dẫn ví dụ về trường hợp kiểm thử API là một tài liệu hữu ích.
Xây dựng kịch bản để chạy các yêu cầu theo trình tự
Một yêu cầu đơn lẻ trả lời một câu hỏi. Kiểm thử thực tế thường có nghĩa là một quy trình: tạo một bản ghi, đọc lại nó, cập nhật nó, xóa nó. Talend API Tester xử lý điều này bằng các kịch bản (scenarios).
Một kịch bản là một danh sách các yêu cầu đã lưu được sắp xếp theo thứ tự. Tạo một kịch bản từ thanh bên, sau đó thêm các yêu cầu vào đó theo thứ tự chúng nên chạy. Khi bạn chạy kịch bản, công cụ sẽ kích hoạt từng yêu cầu từ trên xuống dưới và hiển thị kết quả của mỗi bước.
Phần hữu ích là truyền dữ liệu giữa các bước. Một kịch bản có thể lấy một giá trị từ một phản hồi và đưa nó vào một yêu cầu sau đó. Ví dụ, một yêu cầu “tạo người dùng” trả về một id mới trong phần nội dung phản hồi của nó. Bạn trích xuất id đó vào một biến, sau đó một yêu cầu “lấy người dùng” sau đó sử dụng biến đó trong URL của nó. Đây là cách bạn kiểm thử các quy trình có trạng thái thay vì các cuộc gọi riêng lẻ.
Các kịch bản cũng hỗ trợ logic điều kiện và lặp lại. Bạn có thể phân nhánh dựa trên phản hồi, vì vậy một bước chỉ chạy nếu bước trước đó trả về một trạng thái cụ thể, và bạn có thể lặp lại một bước để gọi một endpoint nhiều lần. Kết hợp với việc trích xuất biến, điều này cho phép một kịch bản duy nhất mô hình hóa một chuỗi thực tế: xác thực, tạo một bản ghi, xác nhận nó đọc lại đúng, sửa đổi nó, sau đó dọn dẹp bằng cách xóa nó. Chạy kịch bản đó từ đầu đến cuối là một tín hiệu tốt hơn nhiều so với việc kích hoạt từng yêu cầu riêng lẻ. Bài viết về kịch bản kiểm thử so với trường hợp kiểm thử giải thích sự khác biệt giữa một kiểm tra đơn lẻ và một quy trình nhiều bước, điều này trực tiếp ánh xạ vào các yêu cầu so với kịch bản ở đây.
Thêm xác nhận để công cụ kiểm tra phản hồi
Chạy một kịch bản cho bạn thấy những gì đã trả về. Các xác nhận (assertions) giúp công cụ quyết định xem những gì đã trả về có đúng hay không, vì vậy bạn không phải đọc từng phản hồi bằng tay.
Talend API Tester cho phép bạn đính kèm các xác nhận vào một yêu cầu. Mở một yêu cầu đã lưu và tìm phần xác nhận. Bạn xây dựng các xác nhận thông qua một biểu mẫu chứ không phải bằng cách viết code. Các xác nhận phổ biến bao gồm:
- Mã trạng thái (Status code) bằng một giá trị mong đợi, chẳng hạn như
200hoặc201. - Thời gian phản hồi (Response time) dưới một ngưỡng, chẳng hạn như
500mili giây. - Một trường payload (payload field) khớp với một giá trị mong đợi, sử dụng một đường dẫn vào nội dung JSON.
- Một tiêu đề (header) tồn tại hoặc có một giá trị cụ thể.
Mỗi xác nhận bạn thêm vào sẽ được đánh giá khi yêu cầu chạy, hoặc riêng lẻ hoặc như một bước trong một kịch bản. Bảng kết quả sẽ đánh dấu mỗi xác nhận là đã qua hoặc đã thất bại. Chạy toàn bộ kịch bản và bạn sẽ nhận được kết quả rõ ràng là đạt hoặc không đạt trên mỗi bước, điều này biến kịch bản thành một kiểm tra hồi quy có thể lặp lại.
Vì các xác nhận dựa trên biểu mẫu chứ không phải code, công cụ này dễ tiếp cận đối với những người kiểm thử không viết JavaScript. Đó là một điểm mạnh thực sự để xác minh thủ công nhanh chóng. Mặt khác, vốn từ vựng xác nhận hẹp hơn so với một công cụ dựa trên kịch bản. Nếu bạn cần xác nhận một điều gì đó mà biểu mẫu không thể diễn tả, chẳng hạn như một giá trị được tính toán hoặc một điều kiện phức tạp trên nhiều trường, bạn sẽ gặp giới hạn. Đối với hầu hết các kiểm tra hàng ngày, mã trạng thái cộng với một vài xác nhận trường nội dung là đủ. Để được hướng dẫn về những gì đáng để xác nhận, hãy xem hướng dẫn chuyên sâu về các xác nhận API.
Đọc phản hồi một cách chính xác
Dù bạn có thêm xác nhận hay không, bạn cũng nên biết cách đọc phản hồi. Bốn phần quan trọng.
- Mã trạng thái (Status code). Đây là tín hiệu đầu tiên.
2xxnghĩa là thành công,4xxnghĩa là yêu cầu sai,5xxnghĩa là máy chủ gặp lỗi. Một tài liệu tham khảo như hướng dẫn về các mã trạng thái HTTP mà API REST nên sử dụng giúp bạn giải thích những mã ít rõ ràng hơn. - Thời gian phản hồi (Response time). Talend API Tester báo cáo thời gian yêu cầu mất. Một endpoint chậm là một vấn đề ngay cả khi nó trả về dữ liệu đúng.
- Tiêu đề (Headers). Tiêu đề mang
Content-Type, chỉ thị bộ nhớ cache, thông tin giới hạn tốc độ, và chi tiết CORS. Chúng thường giải thích hành vi mà phần nội dung không thể. - Nội dung (Body). Dữ liệu thực tế, thường là JSON hoặc XML. Kiểm tra xem các trường, loại và giá trị có đúng như hợp đồng đã cam kết hay không.
Đọc cả bốn phần cùng nhau cho bạn biết liệu API có hoạt động tốt hay không, chứ không chỉ là liệu nó có phản hồi hay không.
Khi tiện ích mở rộng Chrome không đủ
Talend API Tester tiện lợi và nhanh chóng cho các kiểm tra dựa trên trình duyệt. Các giới hạn của nó xuất hiện khi công việc phát triển. Nó bị ràng buộc với Chrome, vì vậy nó không thể chạy không giao diện (headless) trong một pipeline CI. Hệ thống xác nhận của nó chắc chắn nhưng cơ bản so với một nền tảng kiểm thử đầy đủ. Và nó không bao gồm thiết kế API, mocking, hoặc tài liệu, vì vậy nó là một trong số nhiều công cụ chứ không phải một không gian làm việc duy nhất.
Apidog là một nền tảng API tất cả trong một lấp đầy những khoảng trống đó. Nó là một ứng dụng độc lập chứ không phải tiện ích mở rộng trình duyệt, nó nhập Postman, OpenAPI và các định dạng khác giống như Talend API Tester, và nó bổ sung trình xây dựng xác nhận trực quan, máy chủ mock, kịch bản kiểm thử tự động và tài liệu được tạo ra trong một dự án duy nhất. Vì đặc tả và các kiểm thử chia sẻ một nguồn đáng tin cậy duy nhất, chúng không bị lệch nhau. Bạn có thể tải xuống Apidog và nhập các yêu cầu hiện có của bạn để so sánh. Để có một cái nhìn tổng quan rộng hơn về các lựa chọn, so sánh về các công cụ kiểm thử API trực tuyến miễn phí là một điểm khởi đầu tốt.
Talend API Tester vẫn là một lựa chọn tốt cho các kiểm tra nhanh chóng, trong trình duyệt. Hãy chọn công cụ phù hợp với quy mô và giai đoạn công việc kiểm thử của bạn.
Các câu hỏi thường gặp
Talend API Tester có giống với Restlet Client không?
Có. Talend API Tester là phiên bản đổi tên của công cụ trước đây gọi là Restlet Client. Chức năng có cùng nguồn gốc: một tiện ích mở rộng Chrome để gửi các yêu cầu HTTP, sắp xếp chúng và chạy các kịch bản với các xác nhận.
Talend API Tester có miễn phí không?
Có một phiên bản miễn phí có sẵn trên Chrome Web Store bao gồm việc gửi yêu cầu, tổ chức chúng thành các dự án và xây dựng các kịch bản với các xác nhận. Các cấp trả phí trong lịch sử đã bổ sung các tính năng nhóm và giới hạn lớn hơn. Phiên bản miễn phí đủ cho hầu hết các công việc kiểm thử cá nhân.
Talend API Tester có thể chạy kiểm thử trong CI/CD không?
Không trực tiếp. Nó là một tiện ích mở rộng Chrome và chạy bên trong trình duyệt, vì vậy nó không thể thực thi không giao diện (headless) trong một pipeline. Đối với các kiểm thử tự động chạy trên mỗi commit, bạn cần một công cụ có trình chạy dòng lệnh. Hướng dẫn về tự động hóa kiểm thử API trong CI/CD trình bày cách thiết lập đó trông như thế nào.
Talend API Tester có thể nhập các định dạng nào?
Nó có thể nhập các bộ sưu tập Postman, định nghĩa Swagger và OpenAPI, và các tệp HAR. Điều này cho phép bạn đưa vào các đặc tả API hoặc bản xuất hiện có thay vì tạo lại từng yêu cầu theo cách thủ công.
Một kịch bản khác với một yêu cầu đơn lẻ như thế nào?
Một yêu cầu đơn lẻ gửi một cuộc gọi HTTP và hiển thị một phản hồi. Một kịch bản là một danh sách các yêu cầu được sắp xếp theo thứ tự chạy tuần tự, và nó có thể truyền dữ liệu được lấy từ một phản hồi vào một yêu cầu sau đó. Các kịch bản kiểm thử các quy trình nhiều bước, như tạo rồi đọc rồi xóa, trong khi một yêu cầu đơn lẻ kiểm thử một cuộc gọi riêng lẻ.