Postman CLI là một cách hay để chạy các bộ sưu tập Postman của bạn trong một pipeline, nhưng nó lại gắn các lần chạy thử nghiệm của bạn với một tài khoản Postman và đám mây Postman, và điều đó không phù hợp với mọi nhóm. Hướng dẫn này sẽ trình bày năm lựa chọn thay thế vững chắc để chạy thử nghiệm API trong CI, mỗi lựa chọn thực sự tốt ở điểm nào và Apidog CLI phù hợp như thế nào với tư cách là lựa chọn được đề xuất. Để biết thông tin cơ bản về cách Postman CLI liên quan đến người anh em cũ hơn của nó, hãy xem so sánh của Postman về Postman CLI và Newman.
nút
Tại sao các nhóm không sử dụng Postman CLI
Postman CLI là công cụ mà Postman hiện hướng bạn đến để sử dụng trong CI/CD. Nó chạy các bộ sưu tập, báo cáo kết quả và hiển thị các lần chạy đó trong ứng dụng Postman. Phần cuối cùng đó là điểm gây trở ngại cho nhiều nhóm.
Để sử dụng Postman CLI, bạn đăng nhập bằng khóa API Postman và các lần chạy của bạn sẽ báo cáo về đám mây Postman. Điều này tiện lợi nếu toàn bộ quy trình làm việc của bạn đã nằm trong Postman. Đó là một vấn đề nếu bạn gặp phải các rào cản về ràng buộc đám mây, cấp phép hoặc khóa:
- Ràng buộc đám mây. Các lần chạy được xác thực bằng tài khoản Postman, và kết quả thực thi được hiển thị trong ứng dụng Postman. Các cửa hàng bị tách biệt mạng hoặc nhạy cảm về tuân thủ thường không thể chấp nhận vòng lặp đó.
- Cấp phép. Các bộ sưu tập, môi trường và tính năng nhóm nằm sau các cấp gói của Postman. Khi nhóm của bạn phát triển, chi phí cho mỗi người dùng sẽ thay đổi.
- Khóa. Nguồn thông tin đáng tin cậy của bạn là một bộ sưu tập Postman. Việc chuyển khỏi nó sau này có nghĩa là xuất và điều chỉnh lại.
Không có điều nào trong số đó khiến Postman CLI trở nên tệ. Nó chỉ đơn thuần đẩy nhiều nhóm tìm kiếm một trình chạy giữ các bài kiểm tra trong kho lưu trữ riêng của họ, chạy ngoại tuyến và không tính phí theo chỗ ngồi để chạy một pipeline. Dưới đây là năm công cụ đáng để biết.
So sánh nhanh
| Công cụ | Định dạng kiểm tra | Yêu cầu tài khoản để chạy | Giấy phép | Phù hợp nhất cho |
|---|---|---|---|---|
| Apidog CLI | Kịch bản/bộ kiểm tra Apidog, hoặc các tệp đã xuất | Không (dựa trên token để đồng bộ hóa dự án) | Thương mại, cấp miễn phí | Các nhóm thiết kế, giả lập, kiểm tra và lập tài liệu tại một nơi |
| Newman | Postman collection JSON | Không | Mã nguồn mở (Apache-2.0) | Người dùng Postman hiện tại muốn chạy ngoại tuyến |
| Hoppscotch CLI | Hoppscotch collection JSON | Không (đường dẫn xuất JSON) | Mã nguồn mở | Người dùng Hoppscotch, người tự lưu trữ |
| inso (Insomnia CLI) | Bộ kiểm tra Insomnia thông qua đồng bộ Git | Không | Mã nguồn mở | Các nhóm sử dụng Insomnia + Git |
| Hurl | Tệp văn bản thuần túy .hurl |
Không | Mã nguồn mở | Các kỹ sư muốn kiểm tra kiểu curl trong kiểm soát phiên bản |
1. Apidog CLI
Apidog CLI là trình chạy không giao diện (headless runner) cho Apidog, một nền tảng API tất cả trong một bao gồm thiết kế, gỡ lỗi, kiểm thử, mô phỏng và tài liệu. Bạn chạy các kịch bản kiểm thử và bộ kiểm thử từ terminal bằng lệnh apidog run, đây cũng là lệnh bạn sử dụng trong pipeline CI/CD.
Điều làm cho nó trở thành lựa chọn được đề xuất ở đây không chỉ là trình chạy đơn thuần. Đó là việc trình chạy này nằm trên một nguồn dữ liệu duy nhất đáng tin cậy. Hợp đồng OpenAPI của bạn, các kịch bản kiểm thử, máy chủ giả lập và tài liệu của bạn đều nằm trong cùng một dự án, vì vậy một bài kiểm thử trong CI sẽ kiểm tra cùng một API mà bạn đã thiết kế và lập tài liệu. Bạn không cần phải ghép nối bốn công cụ khác nhau.
Điểm mạnh cụ thể cho CI:
apidog runđược xây dựng cho các pipeline. Sao chép lệnh đã tạo từ bảng điều khiển CI/CD và dán vào Jenkins, GitLab hoặc GitHub Actions. Xem hướng dẫn từng bước trong hướng dẫn CLI từng bước.- Kiểm thử dựa trên dữ liệu. Cung cấp tệp CSV hoặc JSON với cờ
-dvà Apidog sẽ lặp lại bài kiểm thử của bạn một lần trên mỗi hàng. Điều này bao gồm các trường hợp tham số hóa mà hầu hết các nhóm thường tự thực hiện ở nơi khác. - Báo cáo phù hợp với mọi pipeline. Cờ
-rxuất ra định dạngcli,html,jsonvàjunit, để bảng điều khiển CI của bạn có thể đọc kết quả một cách tự nhiên và mọi người có thể mở báo cáo HTML. - Giả lập cũng chạy không giao diện. Máy chủ giả lập của Apidog tạo ra các phản hồi từ schema của bạn và chạy trong CI, vì vậy các bài kiểm thử giao diện người dùng và tích hợp không phải chờ backend hoạt động. Để có cái nhìn tổng quát hơn, hãy xem hướng dẫn về giả lập API.
- Tương thích với AI-agent. Máy chủ MCP của Apidog cho phép một tác nhân AI hoặc IDE (Cursor, Claude, VS Code) đọc các thông số kỹ thuật API của bạn và làm việc với chúng. Điều này được đề cập trong máy chủ Apidog MCP.
Apidog có một gói miễn phí và ứng dụng desktop từ Apidog để bạn làm theo. Nếu bạn muốn so sánh trực tiếp Postman-CLI-to-Apidog thay vì danh sách này, hãy đọc Apidog CLI vs Postman CLI.
2. Newman
Newman là trình chạy bộ sưu tập mã nguồn mở ban đầu của Postman, và nó vẫn là lựa chọn quen thuộc nhất đối với các nhóm đã đầu tư vào Postman. Nó chạy Postman collection JSON từ dòng lệnh, không yêu cầu ứng dụng Postman, và đã tồn tại đủ lâu để hầu hết mọi công thức CI bạn tìm kiếm đều có sẵn.
Điểm mạnh thực sự của Newman:
- Nó hoàn toàn là mã nguồn mở theo giấy phép Apache-2.0, vì vậy bạn có thể chạy ngoại tuyến và kiểm tra những gì nó làm.
- Nó đọc các tệp xuất bộ sưu tập Postman tiêu chuẩn, vì vậy việc di chuyển một bộ sưu tập hiện có chỉ là một bước xuất.
- Nó có một hệ sinh thái báo cáo phong phú và một cộng đồng lớn, điều đó có nghĩa là bạn dễ dàng tìm thấy câu trả lời.
Hạn chế: Newman vẫn tập trung vào các bộ sưu tập Postman như là một thành phần. Nếu mục tiêu của bạn là thoát khỏi mô hình bộ sưu tập là nguồn đáng tin cậy, Newman sẽ giữ bạn trong mô hình đó. Postman đã nói rằng không có kế hoạch loại bỏ Newman, vì vậy nó vẫn ổn định. Nếu bạn đang cân nhắc hai trình chạy kiểu Postman, Apidog CLI vs Newman sẽ trình bày sự khác biệt.
3. Hoppscotch CLI
Hoppscotch là một ứng dụng client API mã nguồn mở, có thể tự lưu trữ, và Hoppscotch CLI (@hoppscotch/cli) mang các tập lệnh kiểm thử của nó vào CI. Lệnh hopp test duyệt qua một bộ sưu tập, chạy từng yêu cầu và xác thực các phản hồi dựa trên tập lệnh kiểm thử được đính kèm với mỗi yêu cầu.
Nơi nó tỏa sáng:
- Nó là mã nguồn mở và có thể tự lưu trữ, điều này quan trọng nếu bạn không thể gửi bất cứ thứ gì đến đám mây của nhà cung cấp.
- Bạn có thể chạy các bài kiểm thử từ một tệp JSON đã xuất của bộ sưu tập và môi trường của mình, hoặc bằng ID bộ sưu tập.
- Nó xuất báo cáo JUnit với
--reporter-junit, vì vậy các hệ thống CI nhận kết quả một cách rõ ràng.
Hoppscotch CLI là một lựa chọn tốt nếu bạn đã là người dùng Hoppscotch và thích thiết kế nhẹ, ưu tiên trình duyệt của nó. Nếu bạn đang tìm kiếm trong danh mục rộng hơn, tổng hợp các lựa chọn thay thế Hoppscotch của chúng tôi cũng bao gồm cả mặt GUI.
4. inso (Insomnia CLI)
inso là công cụ dòng lệnh của Kong Insomnia. Nó chạy các bộ kiểm thử mà bạn xây dựng trong Insomnia, và tính năng nổi bật của nó là cách nó kết hợp với tính năng đồng bộ Git của Insomnia. Khi tính năng đồng bộ Git được thiết lập, inso đọc dữ liệu Insomnia của bạn từ thư mục .insomnia trong kho lưu trữ của bạn, vì vậy các thông số kỹ thuật, bộ sưu tập và bộ kiểm thử của bạn trở thành các tệp được kiểm soát phiên bản cùng với mã của bạn.
Điểm mạnh của inso:
- Tích hợp Git. Các bài kiểm thử tồn tại dưới dạng tệp trong kho lưu trữ của bạn, được cam kết và phân nhánh giống như phần còn lại của ngăn xếp của bạn.
- Nó chạy trực tiếp các bộ kiểm thử đã đặt tên, ví dụ:
inso run test "My API Test Suite". - Nó được hỗ trợ bởi Kong và dự án mã nguồn mở Insomnia, và nó tích hợp vào GitHub Actions, GitLab và Jenkins.
Nếu nhóm của bạn đã thiết kế trong Insomnia và muốn kiểm thử trong kiểm soát phiên bản mà không có đám mây của nhà cung cấp, inso là một lựa chọn tự nhiên. Để so sánh tập trung, hãy xem Apidog CLI vs inso.
5. Hurl
Hurl là một trường hợp ngoại lệ ở đây, và đối với một số nhóm, nó là lựa chọn hoàn hảo. Đó là một công cụ dòng lệnh nhỏ chạy các yêu cầu HTTP được viết theo định dạng văn bản thuần túy .hurl. Nó là một tệp nhị phân Rust được hỗ trợ bởi libcurl, vì vậy nó khởi động nhanh và không có phụ thuộc thời gian chạy nào cần cài đặt. Nó là mã nguồn mở, được duy trì bởi Orange dưới tổ chức Orange-OpenSource trên GitHub.
Tại sao các kỹ sư lại sử dụng nó:
- Văn bản thuần túy, có kiểm soát phiên bản. Tệp
.hurlđọc giống như một lệnh curl được chú thích. Nó khác biệt rõ ràng và nằm trong kho lưu trữ của bạn mà không cần bước xuất nào. - Nhanh và ít phụ thuộc. Không có môi trường chạy Node, không GUI, không tài khoản. Nó xâu chuỗi các yêu cầu, nắm bắt giá trị và xác nhận tiêu đề và nội dung.
- Thân thiện với CI ngay từ thiết kế. Bởi vì các bài kiểm thử chỉ là các tệp văn bản và tệp nhị phân trả về các mã thoát tiêu chuẩn, việc kết nối nó vào một pipeline là rất đơn giản.
Hurl không cố gắng trở thành một nền tảng API hoàn chỉnh. Không có giao diện thiết kế, không có máy chủ giả lập, không có tạo tài liệu. Đó là điểm chính. Nếu bạn muốn thứ nhỏ nhất có thể xác nhận các điểm cuối của bạn hoạt động, Hurl rất khó bị đánh bại. Đọc tài liệu Hurl chính thức để xem định dạng.
Cách chọn
Chọn công cụ phù hợp với nơi quy trình làm việc API của bạn hiện có:
- Đã sử dụng Postman sâu, muốn chạy ngoại tuyến: Newman.
- Đang dùng Hoppscotch hoặc tự lưu trữ: Hoppscotch CLI.
- Đang dùng Insomnia và tích hợp Git: inso.
- Muốn tối giản, dựa trên văn bản, không nền tảng: Hurl.
- Muốn một nơi duy nhất để thiết kế, tạo mock, kiểm thử và tài liệu, với một trình chạy liên kết trở lại hợp đồng của bạn: Apidog CLI.
Nếu bạn coi API của mình như một sản phẩm chứ không phải một đống bộ sưu tập, thì lựa chọn cuối cùng sẽ mở rộng tốt nhất. Khung này đáng để đọc trong API như một sản phẩm, và hướng dẫn về các thực tiễn tốt nhất CI/CD để kiểm thử API đề cập đến cách tích hợp bất kỳ công cụ nào trong số này vào một pipeline một cách hiệu quả.
nút
Các câu hỏi thường gặp
Có lựa chọn thay thế Postman CLI miễn phí không?
Có, một số. Newman, Hoppscotch CLI, inso và Hurl đều là mã nguồn mở và miễn phí để chạy. Apidog CLI có cấp độ miễn phí và chạy cùng lệnh apidog run mà bạn sẽ sử dụng trên gói trả phí. Không có công cụ nào trong số đó tính phí bạn cho mỗi lần chạy pipeline.
Tôi có thể chạy các bộ sưu tập Postman hiện có của mình mà không cần Postman CLI không?
Có. Newman đọc trực tiếp tệp JSON bộ sưu tập Postman, và Apidog có thể nhập một bộ sưu tập Postman, sau đó bạn chạy nó mà không cần giao diện người dùng. Chúng tôi đề cập đến đường dẫn di chuyển trong bài cách chạy các bộ sưu tập Postman trong CI mà không cần Newman.
Sự khác biệt giữa Postman CLI và Newman là gì?
Cả hai đều chạy các bộ sưu tập Postman từ dòng lệnh với các đối số tương tự. Postman CLI đăng nhập bằng khóa API Postman và báo cáo các lần chạy về ứng dụng Postman, trong khi Newman là một trình chạy mã nguồn mở độc lập không báo cáo lên đám mây. Postman đã nói rằng họ không có kế hoạch ngừng hỗ trợ Newman.
Lựa chọn thay thế nào là tốt nhất cho CI/CD?
Điều đó phụ thuộc vào hệ thống của bạn. Đối với một nền tảng duy nhất xử lý thiết kế, mô phỏng, kiểm thử và tài liệu với một trình chạy sẵn sàng cho CI, Apidog CLI là lựa chọn được đề xuất. Đối với một trình chạy hoàn toàn dựa trên văn bản mà không có nền tảng đính kèm, Hurl là tuyệt vời. Newman, Hoppscotch CLI và inso mạnh mẽ khi bạn đã sử dụng Postman, Hoppscotch hoặc Insomnia tương ứng.
Tổng kết
Postman CLI hoạt động, nhưng mô hình ràng buộc đám mây và cấp phép của nó đã đẩy nhiều nhóm tìm kiếm các lựa chọn khác. Newman, Hoppscotch CLI, inso và Hurl mỗi công cụ đều đáp ứng một trường hợp sử dụng rõ ràng. Nếu bạn muốn một trình chạy liên kết trở lại một nguồn đáng tin cậy duy nhất cho toàn bộ vòng đời API của bạn, Apidog CLI là lựa chọn nên thử. Tải xuống Apidog và chạy bài kiểm thử đầu tiên của bạn từ dòng lệnh, hoặc đọc thêm về nền tảng tại Apidog.