Posted inDevelopment

Tạm biệt Postman: Tại sao Bruno là chân ái mới để quản lý và kiểm thử API?

Development tutorial - IT technology blog
Development tutorial - IT technology blog

Nỗi lo khi chia sẻ API trong dự án thực tế

Tôi từng tham gia một dự án microservices cho ngân hàng với team 5 người. Lúc đó, cả đội dùng Postman để test API và gặp một kịch bản rất mệt mỏi. Mỗi khi thêm endpoint mới hoặc sửa cấu trúc JSON, tôi phải Export Collection ra file JSON nặng vài MB. Sau đó, tôi lại gửi file này qua Slack hoặc đính kèm vào Jira để anh em khác import lại.

Ác mộng thực sự đến khi hai người cùng sửa một Collection. Khi gửi file lên, dữ liệu bị đè, làm mất sạch các script test quan trọng. Việc quản lý phiên bản (version control) lúc đó là một thảm họa. Nhiều công ty tài chính còn cấm đẩy dữ liệu API lên Cloud bên thứ ba. Trong khi đó, Postman liên tục ép người dùng đăng nhập và đồng bộ dữ liệu lên máy chủ của họ.

Tại sao Postman hay Insomnia dần trở nên cồng kềnh?

Vấn đề không nằm ở tính năng vì Postman vốn rất mạnh. Cái khó chịu nằm ở triết lý thiết kế. Postman đang chuyển mình thành một nền tảng SaaS phức tạp thay vì một công cụ phát triển thuần túy.

  • Xung đột Git: File Export của Postman là một khối JSON khổng lồ trên một dòng. Khi đưa vào Git, việc merge conflict là không thể tránh khỏi. Bạn gần như không thể giải quyết các xung đột này bằng tay.
  • Ép buộc dùng Cloud: Việc bắt buộc đăng nhập để dùng tính năng nâng cao gây lo ngại về bảo mật. Với các dự án nhạy cảm, đây là một điểm trừ rất lớn.
  • Ngốn tài nguyên: Postman thường chiếm dụng từ 500MB đến hơn 1GB RAM. Tốc độ khởi động chậm chạp do gánh quá nhiều tính năng thừa thãi.

Các giải pháp thay thế thường gặp

Để thoát khỏi cảnh này, cộng đồng developer thường cân nhắc ba phương án:

  1. Swagger/OpenAPI: Công cụ này rất tốt để làm tài liệu (documentation). Tuy nhiên, việc viết script kiểm thử tự động trên giao diện này khá rườm rà.
  2. VS Code REST Client: Extension này rất hay, lưu API trong file .http. Tuy nhiên, giao diện thuần text sẽ gây khó khăn khi bạn cần quản lý hàng trăm API phức tạp.
  3. Chấp nhận thực tại: Tiếp tục dùng Postman và sống chung với lũ. Bạn sẽ phải cực kỳ cẩn thận mỗi khi export hay import dữ liệu.

Bruno – Cách tiếp cận khác biệt để quản lý API

Sau nhiều lần đau đầu giải quyết conflict file JSON, tôi đã tìm thấy Bruno. Đây là API Client mã nguồn mở với tư duy Git-friendly. Thay vì gom tất cả vào một file duy nhất, Bruno lưu mỗi request thành một file .bru riêng biệt. Các file này được lưu trực tiếp trong thư mục dự án của bạn với định dạng gần giống YAML.

Cài đặt Bruno nhanh chóng

Việc cài đặt rất gọn nhẹ. Bạn có thể tải bản cài cho Windows, macOS hoặc Linux từ trang chủ. Nếu dùng Mac và có Homebrew, bạn chỉ cần chạy một lệnh duy nhất:

brew install bruno

Tạo Collection và tích hợp thẳng vào Git

Sự khác biệt lớn nhất là Bruno yêu cầu bạn chọn một thư mục trên máy tính khi tạo Collection. Tôi thường chọn folder /api-tests nằm ngay trong source code dự án. Khi tạo một request GET, Bruno sinh ra một file có nội dung như sau:

get {
  url: https://api.itfromzero.com/v1/posts
  body: none
  auth: none
}

query {
  page: 1
  limit: 10
}

Cấu trúc này cực kỳ dễ đọc. Vì là plain text, đồng nghiệp chỉ cần git pull là có đầy đủ bộ API để test. Bạn không cần import thủ công bất cứ thứ gì. Nếu xảy ra conflict, bạn dễ dàng dùng VS Code để so sánh và sửa lỗi như sửa code bình thường.

Quản lý biến môi trường (Environments)

Bruno hỗ trợ đầy đủ các môi trường như Local, Staging hay Production. Bạn có thể tạo file môi trường để lưu URL hoặc Token. Đặc biệt, tính năng “Secret” giúp ẩn các biến nhạy cảm, tránh việc vô tình commit chúng lên GitHub. Cách gọi biến vẫn rất quen thuộc: {{base_url}}/users.

Viết Test Script bằng JavaScript chuẩn

Tôi từng refactor một hệ thống hơn 50.000 dòng code. Bài học xương máu là phải có test coverage tốt trước khi bắt đầu. Bruno cho phép bạn viết script JavaScript ngay trong tab “Tests” để kiểm tra response. Ví dụ, để kiểm tra API trả về status 200 và có trường id:

test("Status code is 200", function() {
  expect(res.getStatus()).to.equal(200);
});

test("Response has user id", function() {
  const data = res.getBody();
  expect(data.id).to.be.a('number');
});

Tại sao tôi chọn Bruno cho các dự án dài hơi?

Trong làm việc nhóm, công cụ tốt nhất là công cụ giúp phối hợp mượt mà nhất. Từ ngày chuyển sang Bruno, quy trình của team tôi thay đổi hoàn toàn.

  • Review API ngay trên Pull Request: Khi Backend thêm API mới, họ chỉ cần đẩy file .bru lên. Tôi có thể review cấu trúc API và header trực tiếp trên GitHub.
  • Hoạt động Offline 100%: Bruno không bắt đăng nhập. Ngay cả khi ngồi trên máy bay không có mạng, tôi vẫn mở app và viết script test bình thường.
  • Tốc độ vượt trội: Ứng dụng cực nhẹ, mở là dùng ngay. Bạn sẽ không bao giờ phải nhìn màn hình loading “Syncing…” gây ức chế như trước.

Nếu bạn mệt mỏi vì quản lý file JSON hay lo ngại bảo mật, hãy thử cài Bruno ngay. Ban đầu có thể bạn sẽ thấy lạ lẫm vì Bruno tự động lưu (không có nút Save). Tuy nhiên, sự tiện lợi khi quản lý API bằng Git sẽ khiến bạn không muốn quay lại công cụ cũ.

Share:
Tags: