Tóm tắt
Gói miễn phí của Postman giới hạn việc chia sẻ bộ sưu tập theo những cách khiến nhiều nhà phát triển bất ngờ. Nếu bạn cần cộng tác với đồng đội mà không phải trả 19$/người dùng/tháng, bạn có một vài giải pháp thay thế, nhưng mỗi giải pháp đều có những đánh đổi thực tế. Gói miễn phí của Apidog cho phép bạn chia sẻ không gian làm việc với tối đa 3 người dùng mà không cần nâng cấp.
Giới thiệu
Postman bắt đầu như một tiện ích mở rộng đơn giản của Chrome để gửi các yêu cầu HTTP. Trong những năm qua, nó đã phát triển thành một nền tảng API hoàn chỉnh và giá cả của nó cũng tăng lên theo. Ngày nay, các nhóm muốn chia sẻ bộ sưu tập và cộng tác trong thời gian thực cần một gói trả phí. Gói miễn phí khiến nhiều nhà phát triển phải tìm kiếm các giải pháp thay thế.
Nếu bạn đang điều hành một nhóm nhỏ, một dự án phụ hoặc một công ty khởi nghiệp mà mỗi đồng đều quý giá, việc trả 19 đô la mỗi người dùng mỗi tháng chỉ để chia sẻ một bộ sưu tập có vẻ rất nhiều. Đó là 228 đô la mỗi người mỗi năm trước khi bạn triển khai một tính năng duy nhất.
Tin tốt là có những cách hợp lệ để chia sẻ bộ sưu tập Postman trên gói miễn phí. Không cách nào trong số đó mượt mà bằng việc trả tiền cho gói Team, nhưng chúng vẫn hoạt động. Hướng dẫn này sẽ trình bày từng phương pháp, giải thích những điểm hạn chế và cho bạn thấy một giải pháp thay thế miễn phí thực sự trông như thế nào.
Những gì gói miễn phí của Postman thực sự cho phép
Trước khi xem xét các giải pháp thay thế, việc hiểu những gì gói miễn phí bao gồm tính đến năm 2024-2025 sẽ rất hữu ích.
Gói miễn phí của Postman cung cấp cho bạn:
- 1 người dùng mỗi không gian làm việc (không có chỉnh sửa chung)
- Tối đa 3 không gian làm việc công khai đang hoạt động
- Không giới hạn không gian làm việc cá nhân
- 1.000 cuộc gọi máy chủ giả lập mỗi tháng
- 1.000 cuộc gọi giám sát mỗi tháng
- Số lần chạy bộ sưu tập giới hạn ở 25 lần mỗi tháng trên cloud runner
Hạn chế quan trọng: bạn không thể mời đồng đội vào một không gian làm việc riêng tư trên gói miễn phí. Không gian làm việc riêng tư yêu cầu ít nhất gói Basic với giá 19$/người dùng/tháng. Đó là rào cản mà hầu hết các nhóm nhỏ gặp phải đầu tiên.
Phương pháp 1: Xuất bộ sưu tập dưới dạng JSON và chia sẻ tệp
Giải pháp trực tiếp nhất là xuất bộ sưu tập của bạn dưới dạng tệp JSON và gửi cho đồng đội.
Cách thực hiện:
- Mở Postman và điều hướng đến bộ sưu tập của bạn trong thanh bên trái.
- Nhấp vào menu ba chấm bên cạnh tên bộ sưu tập.
- Chọn “Export.”
- Chọn định dạng Collection v2.1 (đây là tiêu chuẩn hiện tại và có khả năng tương thích rộng nhất).
- Lưu tệp JSON và chia sẻ qua email, Slack hoặc ổ đĩa chung.
Đồng đội của bạn nhập nó bằng cách vào File > Import và kéo tệp JSON vào.
Những điểm hạn chế:
Tại thời điểm bạn xuất, bộ sưu tập trở thành một bản chụp nhanh. Nếu bạn thêm một endpoint mới hoặc sửa một yêu cầu, đồng đội của bạn sẽ không biết. Họ đang làm việc với một bản sao cũ.
Các biến môi trường không đi kèm với bộ sưu tập theo mặc định. Bạn cần xuất các môi trường riêng biệt, và đồng đội của bạn cũng phải nhập chúng. Nếu bạn quên một biến, các yêu cầu của họ sẽ thất bại và họ sẽ mất thời gian gỡ lỗi một thứ thực sự không bị hỏng.
Không có quy trình hợp nhất. Nếu hai người chỉnh sửa bản sao cục bộ của họ đồng thời và sau đó cố gắng đối chiếu chúng, bạn sẽ phải thực hiện thủ công.
Phương pháp này hoạt động tốt cho các lần bàn giao một lần không thường xuyên. Nó nhanh chóng đổ vỡ khi bộ sưu tập thay đổi liên tục.
Phương pháp 2: Sử dụng không gian làm việc công khai
Postman cho phép bạn tạo các không gian làm việc công khai trên gói miễn phí. Bất kỳ ai có liên kết đều có thể xem và nhân bản bộ sưu tập.
Cách thiết lập:
- Tạo một không gian làm việc mới trong Postman.
- Khi được nhắc chọn chế độ hiển thị, chọn “Public.”
- Thêm bộ sưu tập của bạn vào không gian làm việc công khai.
- Chia sẻ URL không gian làm việc với đồng đội của bạn.
Đồng đội của bạn có thể nhân bản bộ sưu tập vào không gian làm việc của riêng họ và làm việc từ đó.
Những điểm hạn chế:
Công khai nghĩa là công khai. Bất kỳ ai trên internet cũng có thể tìm và xem bộ sưu tập của bạn nếu họ có URL hoặc tìm kiếm trên mạng API công khai của Postman. Đối với các công cụ nội bộ, môi trường staging hoặc bất kỳ thứ gì có mã thông báo xác thực được nhúng vào các phản hồi ví dụ, đây là một rủi ro đáng kể.
Các bộ sưu tập đã được nhân bản không tự động đồng bộ hóa. Nếu bạn cập nhật bản gốc, đồng đội cần tự kéo các thay đổi vào bản nhân bản của họ. Không có thông báo nào cho biết có thay đổi xảy ra.
Bình luận và cộng tác trực tiếp vẫn yêu cầu gói Team. Các không gian làm việc công khai chỉ dành cho người xem; họ không thể chỉnh sửa bản gốc.
Phương pháp này hoạt động tốt cho các dự án mã nguồn mở hoặc tài liệu API công khai. Nó không phù hợp với quy trình làm việc của nhóm nội bộ.
Phương pháp 3: Sử dụng kho lưu trữ Git làm lớp đồng bộ hóa
Một số nhóm giải quyết vấn đề đồng bộ hóa bằng cách coi JSON đã xuất là một tạo phẩm mã và cam kết nó vào một kho lưu trữ Git.
Quy trình làm việc trông như thế này:
- Một người sở hữu bộ sưu tập Postman và xuất nó sau mỗi thay đổi có ý nghĩa.
- Họ cam kết JSON đã cập nhật vào một kho Git chung (GitHub, GitLab, Bitbucket).
- Đồng đội kéo phiên bản mới nhất và nhập nó vào Postman cục bộ của họ.
Những điểm hạn chế:
Mỗi lần nhập sẽ ghi đè lên bộ sưu tập cục bộ hiện có. Nếu một đồng đội đã thực hiện các thay đổi cục bộ, những thay đổi đó sẽ biến mất trừ khi họ xuất và hợp nhất trước.
Quy trình làm việc đòi hỏi kỷ luật. Ai đó phải nhớ xuất và cam kết mỗi khi có điều gì đó thay đổi. Trên thực tế, phiên bản Git hầu như luôn chậm hơn trạng thái Postman thực tế.
Bạn không thể chạy yêu cầu trực tiếp từ kho Git. Ai đó luôn phải thực hiện bước nhập, điều này tốn thời gian và tạo ra sự cản trở.
Phương pháp này tốt hơn so với chia sẻ tệp thô vì nó cung cấp cho bạn lịch sử và một nguồn chân lý duy nhất, nhưng các bước thủ công làm tăng chi phí chung làm chậm các nhóm.
Phương pháp 4: Sử dụng không gian làm việc cá nhân miễn phí của Postman với một tài khoản “chính” duy nhất
Một số nhóm nhỏ giải quyết hạn chế về cộng tác bằng cách cho mọi người chia sẻ một tài khoản Postman. Một người đăng nhập trên nhiều máy bằng cùng một thông tin đăng nhập.
Điều này vi phạm Điều khoản dịch vụ của Postman và tạo ra các vấn đề thực sự:
- Postman có thể phát hiện thông tin đăng nhập được chia sẻ và khóa tài khoản.
- Các thay đổi do một người thực hiện có thể ghi đè lên các thay đổi do người khác thực hiện nếu xảy ra xung đột đồng bộ hóa.
- Không có cách nào để gán các thay đổi cho những người cụ thể.
Phương pháp này được đề cập ở đây vì các nhóm có sử dụng nó, không phải vì đó là một ý tưởng hay.
Cách Apidog xử lý việc chia sẻ ở gói miễn phí
Apidog có một cách tiếp cận khác đối với vấn đề cộng tác. Gói miễn phí bao gồm tối đa 3 thành viên nhóm trong một không gian làm việc được chia sẻ, với đồng bộ hóa thời gian thực giữa tất cả họ. Không có giải pháp thay thế, không cần sắp xếp tệp JSON.
Khi bạn thực hiện thay đổi đối với định nghĩa API trong Apidog, đồng đội của bạn sẽ thấy ngay lập tức. Tất cả các bạn đều làm việc từ cùng một nguồn đáng tin cậy mà không cần bất kỳ ai phải xuất hoặc nhập bất cứ thứ gì.
Nếu bạn đã sử dụng Postman, bạn có thể nhập các bộ sưu tập hiện có của mình trực tiếp. Apidog đọc định dạng Postman Collection v2.1, vì vậy việc chuyển đổi chỉ cần một cú nhấp chuột, không phải là một dự án cuối tuần.
Gói miễn phí cũng bao gồm:
- Trình chỉnh sửa thiết kế API đầy đủ (OpenAPI 3.0 và Swagger)
- Mock thông minh để tạo phản hồi thực tế mà không phụ thuộc vào đám mây
- Trình chạy kiểm thử không giới hạn số lần chạy hàng tháng
- Tài liệu API được tạo tự động từ các định nghĩa của bạn
- Lưu trữ cục bộ, vì vậy dữ liệu của bạn vẫn nằm trên máy của bạn trừ khi bạn chọn đồng bộ hóa
Đối với một nhóm từ 2-3 người, gói miễn phí của Apidog bao gồm các tính năng tương tự như gói Team của Postman, mà không tốn phí.
Chọn phương pháp phù hợp cho tình huống của bạn
Dưới đây là hướng dẫn đưa ra quyết định nhanh:
| Tình huống | Phương pháp tốt nhất |
|---|---|
| Bàn giao một lần, bộ sưu tập ổn định | Xuất JSON và chia sẻ tệp |
| Dự án mã nguồn mở, không có dữ liệu nhạy cảm | Không gian làm việc công khai của Postman |
| Nhóm nhà phát triển, phát triển tích cực | Gói miễn phí của Apidog |
| Đã có trên Git, muốn có lịch sử phiên bản | Quy trình làm việc Git + xuất JSON |
Nếu nhóm của bạn đang tích cực xây dựng API và bạn gặp phải giới hạn chia sẻ của Postman, các giải pháp JSON và Git sẽ làm bạn chậm lại. Chúng giải quyết vấn đề tức thời nhưng lại thêm sự cản trở liên tục.
Câu hỏi thường gặp
Tôi có thể chia sẻ bộ sưu tập Postman mà không cần tài khoản không?Có. Xuất bộ sưu tập dưới dạng tệp JSON và gửi trực tiếp tệp. Người nhận có thể nhập nó mà không cần tài khoản Postman nếu họ đang sử dụng một client API hỗ trợ định dạng Postman Collection v2.1, bao gồm Apidog.
Gói Postman Basic có cho phép chia sẻ nhóm không?Có. Gói Basic với giá 19$/người dùng/tháng cho phép cộng tác không gian làm việc riêng tư với nhiều người dùng. Gói miễn phí thì không.
Không gian làm việc công khai của Postman là gì?Không gian làm việc công khai hiển thị cho bất kỳ ai trên internet. Khách truy cập có thể xem và nhân bản bộ sưu tập nhưng không thể chỉnh sửa bản gốc. Bạn có thể tạo tối đa 3 không gian làm việc công khai miễn phí trên gói miễn phí.
Các biến môi trường của tôi có được xuất cùng với bộ sưu tập không?Không. Các biến môi trường được xuất riêng. Đi tới Environments trong thanh bên, nhấp vào menu ba chấm trên môi trường bạn cần và xuất nó dưới dạng một tệp JSON riêng biệt. Chia sẻ cả hai tệp với đồng đội của bạn.
Bao nhiêu người dùng có thể chia sẻ không gian làm việc trên gói miễn phí của Apidog?Gói miễn phí của Apidog hỗ trợ tối đa 3 người dùng trong một không gian làm việc được chia sẻ với đồng bộ hóa thời gian thực, không yêu cầu thẻ tín dụng.
Tôi có thể nhập các bộ sưu tập Postman hiện có của mình vào Apidog không?Có. Apidog hỗ trợ nhập trực tiếp các tệp JSON Postman Collection v2.1. Đi tới Import trong Apidog, chọn tệp của bạn và bộ sưu tập của bạn sẽ được nhập với các yêu cầu, tiêu đề và biến môi trường còn nguyên vẹn.
Những hạn chế chia sẻ trên gói miễn phí của Postman là có thật, và các giải pháp thay thế có những chi phí thực tế về thời gian và độ tin cậy. Đối với các nhóm tối đa 3 người cần cộng tác thực sự, việc chuyển sang một công cụ được xây dựng để chia sẻ ở gói miễn phí thường đơn giản hơn là vá víu một quy trình làm việc đòi hỏi nỗ lực thủ công liên tục.