Trả lời ngắn: Postman đã đi xa khỏi vai trò gửi thử một yêu cầu — nó thành nơi lưu bộ tài liệu sống về giao diện lập trình của cả đội.
Đánh đổi: phần mềm ngày càng nặng và nhiều tính năng đòi hỏi phải đăng nhập tài khoản.
Vì sao cần công cụ riêng để gọi thử?
Khi xây một dịch vụ máy chủ, bạn cần gọi thử từng chức năng để xem nó trả về đúng chưa.
Cách sơ khai là gõ lệnh trong cửa sổ dòng lệnh. Việc đó chạy được, nhưng mỗi lần muốn thử lại bạn phải nhớ hoặc chép lại câu lệnh dài, và chia sẻ cho đồng nghiệp thì gửi qua tin nhắn.
Công cụ chuyên dụng biến những lời gọi đó thành thứ lưu lại được, đặt tên được, nhóm theo thư mục được, và chia sẻ cho cả đội được.
Đến khi bộ sưu tập đủ đầy đủ, nó trở thành tài liệu mô tả dịch vụ của bạn — thứ mà người mới vào nhóm mở ra là hiểu ngay hệ thống có những chức năng gì.
Postman làm được gì?
| Việc | Mức độ | Ghi chú |
|---|---|---|
| Lưu và tổ chức bộ lời gọi theo thư mục | Tốt nhất | Thành tài liệu sống cho cả đội |
| Tách biến theo môi trường phát triển và thật | Tốt nhất | Đổi môi trường bằng một lần chọn |
| Viết kiểm thử tự động cho từng lời gọi | Rất tốt | Chạy cả bộ và xem báo cáo |
| Chia sẻ và đồng bộ giữa các thành viên | Rất tốt | Cần tài khoản và có giới hạn theo gói |
| Sinh mã gọi sẵn cho nhiều ngôn ngữ | Rất tốt | Chép thẳng vào dự án được |
| Giả lập máy chủ để làm giao diện trước | Tốt | Rất hữu ích khi máy chủ chưa xong |
| Mức tiêu tốn tài nguyên | Kém | Nặng hơn nhiều so với nhu cầu cơ bản |
| Làm việc hoàn toàn ngoại tuyến | Kém | Nhiều tính năng buộc đăng nhập |
| Giới hạn của gói miễn phí | Khá | Đội đông người sẽ chạm ngưỡng |
Ai nên dùng Postman?
- Người xây dịch vụ máy chủ cho ứng dụng — nhóm dùng nhiều nhất.
- Lập trình viên giao diện cần thử dịch vụ của đồng nghiệp — đỡ phải hỏi đi hỏi lại.
- Người kiểm thử phần mềm — viết được bộ kiểm thử tự động chạy hằng ngày.
- Đội cần bàn giao tài liệu kỹ thuật cho đối tác — xuất ra bộ sưu tập là xong.
Quá nặng nếu bạn chỉ thỉnh thoảng gọi thử vài lời gọi — Insomnia nhẹ hơn nhiều cho nhu cầu đó.
Tổ chức bộ sưu tập thế nào cho hiệu quả?
Đây là chỗ tách biệt giữa một đống lời gọi lộn xộn và một bộ tài liệu thật sự dùng được.
| Việc nên làm | Lợi ích |
|---|---|
| Đặt tên lời gọi theo nghiệp vụ chứ không theo đường dẫn | Người mới đọc là hiểu ngay |
| Nhóm theo chức năng nghiệp vụ | Tìm nhanh hơn hẳn danh sách phẳng |
| Tách biến môi trường ra khỏi lời gọi | Không phải sửa tay khi đổi máy chủ |
| Ghi mô tả ngắn cho từng lời gọi | Giảm số câu hỏi lặp lại trong nhóm |
| Lưu ví dụ kết quả trả về | Người làm giao diện dựng được trước |
| Để lẫn lời gọi thử nghiệm với lời gọi chính thức | Bộ sưu tập nhanh chóng thành rác |
Quy trình dựng bộ sưu tập cho một dự án
- Tạo môi trường riêng cho phát triển và cho bản thật (30 phút) — Tách ngay từ đầu.
- Khai báo địa chỉ máy chủ thành biến (15 phút) — Không viết cứng vào từng lời gọi.
- Thêm từng lời gọi kèm mô tả ngắn (2 giờ) — Làm dần theo tiến độ dự án.
- Lưu ví dụ kết quả trả về cho mỗi lời gọi (1 giờ) — Người làm giao diện dùng ngay.
- Viết kiểm tra tự động cho các lời gọi quan trọng (3 giờ) — Bắt lỗi sớm khi máy chủ đổi.
- Chia sẻ cho nhóm nhưng không kèm khoá thật (30 phút) — Mỗi người tự đặt khoá riêng.
Vì sao nên lưu ví dụ kết quả trả về?
Đây là bước bị bỏ qua nhiều nhất, trong khi nó tháo được một nút thắt lớn về tiến độ.
Trong dự án có cả phần giao diện và phần máy chủ, người làm giao diện thường phải chờ máy chủ xong mới bắt đầu ghép được. Thời gian chờ đó là lãng phí thuần tuý.
Nếu hai bên thống nhất trước hình dạng dữ liệu và lưu ví dụ vào bộ sưu tập, người làm giao diện dựng luôn màn hình dựa trên ví dụ đó. Đến khi máy chủ xong, việc ghép chỉ còn là đổi địa chỉ.
Lợi ích thứ hai lớn không kém là nó buộc hai bên thoả thuận rõ ràng ngay từ đầu. Rất nhiều tranh cãi cuối dự án bắt nguồn từ việc mỗi bên hiểu một kiểu về tên trường và kiểu dữ liệu, và một ví dụ cụ thể chấm dứt được chuyện đó.
Hạn chế cần biết
Nặng hơn nhiều so với nhu cầu cơ bản
Chỉ gọi thử vài lời gọi thì quá thừa.
Nhiều tính năng buộc phải đăng nhập
Làm việc hoàn toàn ngoại tuyến khá bất tiện.
Gói miễn phí có giới hạn với đội đông
Số lần gọi chung và số thành viên bị chặn.
Dễ để lộ khoá truy cập khi chia sẻ
Cần kỷ luật về cách lưu giá trị bí mật.
Bộ sưu tập dễ thành rác nếu không dọn
Lời gọi thử nghiệm tích tụ theo thời gian.
Postman so với các công cụ khác
| Tiêu chí | Postman | Insomnia | Gõ lệnh thủ công |
|---|---|---|---|
| Tổ chức bộ sưu tập lớn | Tốt nhất | Tốt | Kém |
| Kiểm thử tự động | Tốt nhất | Tốt | Khá |
| Nhẹ và nhanh | Kém | Rất tốt | Tốt nhất |
| Làm việc ngoại tuyến | Kém | Rất tốt | Tốt nhất |
| Chia sẻ cho cả đội | Tốt nhất | Tốt | Kém |
| Giả lập máy chủ | Rất tốt | Khá | Không có |
Xem thêm đánh giá Insomnia, đánh giá Docker, đánh giá DBeaver, hoặc duyệt nhóm công cụ lập trình.
Kết luận
Postman đáng dùng khi đội bạn đủ đông để bộ sưu tập trở thành tài liệu chung chứ không chỉ là ghi chú cá nhân.
Ở quy mô đó, phần đầu tư vào việc đặt tên và mô tả tử tế hoàn lại rất nhanh, vì nó cắt bớt được rất nhiều câu hỏi lặp đi lặp lại giữa các thành viên.
Nhưng hãy giữ kỷ luật về khoá truy cập ngay từ ngày đầu. Một bộ sưu tập tiện lợi mà mang theo khoá của môi trường thật là rủi ro lớn hơn nhiều so với thời gian nó tiết kiệm được.
