API (Giao diện lập trình ứng dụng) là một trong những công nghệ nền tảng cốt lõi, tạo nên thế giới kết nối của chúng ta. Chúng cho phép các chương trình giao tiếp với nhau dù được viết bằng ngôn ngữ khác biệt, giúp trình duyệt nhận dữ liệu cần thiết để hiển thị trang web cho người dùng, và hỗ trợ nhà phát triển tạo tiện ích mở rộng Chrome hoặc các công cụ khác mà không cần truy cập trực tiếp vào mã nguồn của chương trình họ đang yêu cầu dữ liệu.
Tuy nhiên, không chỉ các nguồn được lưu trữ bởi công ty khác mới có thể truy vấn bằng API. Hầu hết các dịch vụ tự lưu trữ (self-hosted services) như Home Assistant, đều cung cấp API để bạn có thể xây dựng các tác vụ tự động hóa và bảng điều khiển riêng mà không cần sửa đổi mã nguồn của instance HA. Cách duy nhất để đảm bảo các lệnh gọi API này được xử lý đúng cách là kiểm thử chúng, và đó chính là lúc các ứng dụng kiểm thử API phát huy vai trò. Postman có lẽ là công cụ nổi tiếng nhất, nhưng cấu trúc dựa trên đám mây hạn chế và hệ thống phiên bản độc quyền của nó lại đi ngược lại triết lý tự lưu trữ. Sẽ ra sao nếu bạn có thể kiểm thử API trực tiếp từ máy tính của mình mà không cần đám mây, và tất cả các ví dụ đã kiểm thử của bạn đều nằm gọn trong kho lưu trữ Git của mã nguồn đó? Bruno chính là câu trả lời, và biểu tượng của dịch vụ này là một chú chó hạnh phúc, điều mà bạn khó có thể từ chối.
Tại sao Bruno là lựa chọn hàng đầu cho các dịch vụ tự host API?
Kiểm thử API không giới hạn và tích hợp Git mạnh mẽ
Dù bạn đang mày mò các thiết bị thông minh để tìm cách tích hợp chúng vào Home Assistant khi chưa có sẵn integration, hay đang xây dựng một hệ thống giám sát với Grafana và InfluxDB, API đều hiện diện ở khắp mọi nơi. Bạn có thể sử dụng API để kéo thông tin từ các trang web, lấy dữ liệu thời tiết, kết quả thể thao hoặc bất kỳ thông tin cần thiết nào, thiết lập các bảng điều khiển để giám sát, hoặc chuỗi một script gọi API để sử dụng dữ liệu đó cho các mục đích khác.
Nhưng để biết liệu các lệnh gọi API của bạn có đang hoạt động hay không, bạn cần một phương pháp kiểm thử hiển thị cả chức năng trả về và mức độ bảo mật. Các công cụ kiểm thử API như Bruno cho phép bạn thiết lập các API mà bạn gọi, sau đó viết các script kiểm thử bằng JavaScript để mô phỏng hành vi người dùng. Nó cũng có thể liên kết với GitHub Actions và các nền tảng khác, giúp bạn tự động hóa quy trình kiểm thử, rất lý tưởng cho các cơ sở mã nguồn lớn.
Mặc dù Bruno có các gói đăng ký cho các tính năng nâng cao, nhưng phiên bản miễn phí vẫn đáp ứng rất tốt nhu cầu của tôi. Với gói miễn phí, bạn sẽ nhận được:
- API Clients đa dạng: Hỗ trợ HTTP, Rest, GraphQL, Kiểm thử (Testing), Tài liệu (Documentation), Lập trình script (Scripting), Xác thực (Auth), Quản lý bí mật (Secret Management), Tạo mã (Code Generation).
- Tích hợp Git (Git Integration).
- Nhập khẩu OAS (OAS Import).
Tất nhiên, bạn có thể nhập các môi trường (environments) từ Postman để truy cập chúng từ đám mây của Postman vào máy tính của mình. Xuất dữ liệu từ Postman sẽ cung cấp cho bạn một tệp JSON, sau đó bạn có thể nhập vào Bruno chỉ trong một bước. Các gói đăng ký trả phí cho phép nhập toàn bộ dữ liệu từ Postman, điều này sẽ rất tiện lợi cho các nhóm lớn. Tuy nhiên, tính năng này không bắt buộc, và tôi dám cá rằng nhiều nhà phát triển tự host sẽ chỉ có các bộ sưu tập API nhỏ hơn cần giải nén khỏi cấu trúc độc quyền của Postman.
Giao diện chính của Bruno API Client hiển thị các tùy chọn kiểm thử API
Quyền làm chủ dữ liệu: Hoạt động cục bộ, không phụ thuộc đám mây
Điểm hấp dẫn lớn nhất của Bruno không phải là sự đơn giản của IDE và cách sự đơn giản đó có thể tạo nên điều mạnh mẽ. Đó là việc bạn hoàn toàn làm chủ dữ liệu của mình, cho dù nó được lưu trữ trên máy tính cục bộ hay trong kho lưu trữ Git của mã nguồn liên quan. Việc giữ dữ liệu trong cùng một repo cung cấp cho bất kỳ nhà phát triển mới nào của mã nguồn đó một bản ghi có thể xem ngay lập tức về cách API hoạt động, với các điểm cuối, kết quả mong muốn và nhiều hơn nữa, giúp họ không phải giải mã lại mã nguồn khi bắt đầu dự án.
Biểu tượng (logo) của Bruno với hình chú chó thân thiện, đại diện cho công cụ kiểm thử API hiệu quả
Bruno giúp đơn giản hóa quy trình debug và phát triển API như thế nào?
Trợ thủ đắc lực cho Home Assistant và IoT tự xây
Tôi đã sử dụng Bruno để tìm hiểu cách tương tác với Home Assistant instance của mình. Tất cả các API đó đều sử dụng khóa API bí mật cho HA của tôi, vì vậy tôi không thể chụp ảnh màn hình. Nhưng tôi đã tạo một bộ sưu tập kiểm thử và một số lệnh gọi GET và POST đơn giản tới httpbin để minh họa việc sử dụng Bruno dễ dàng như thế nào để thiết lập thư viện API cho các dịch vụ của bạn và kiểm thử chúng để nhận phản hồi mong muốn.
Thành thật mà nói, tôi không biết tại sao trước đây tôi lại làm theo cách khó khăn: mã hóa cứng các yêu cầu. Với Bruno, tôi có thể xem toàn bộ phản hồi, các tiêu đề đã gửi, dòng thời gian của yêu cầu và phản hồi, cùng kết quả của bất kỳ kiểm thử nào đã thực hiện trên kết quả trả về của API (nếu tôi đang chạy bất kỳ, tôi chưa hoàn toàn ở giai đoạn học tập đó). Tôi có thể thêm các tham số chỉ với vài cú nhấp chuột, chạy lại lệnh gọi API và xem kết quả tức thì của các thay đổi mà không cần phải viết mã để hiển thị phản hồi.
Tôi chưa bao giờ thực sự quan tâm đến “cái nhìn đằng sau bức màn”. Ý tôi là, tôi biết API được sử dụng như thế nào, và tôi đã làm một số phát triển web cơ bản ở trường đại học nhiều thập kỷ trước, nhưng sau khi sử dụng Home Assistant, tôi muốn mở rộng ngôi nhà thông minh của mình với các cảm biến tùy chỉnh và các thiết bị khác sử dụng ESPHome. Và thực sự, cách tốt nhất để làm điều đó là hiểu cách API hoạt động, và những phần nào của nó tôi cần đưa vào bảng điều khiển HA của mình để dễ dàng điều khiển những thứ tôi không cần hoặc không muốn tự động hóa.
Tạm biệt Postman: Sự lựa chọn tối ưu cho người dùng tự host
Tôi không thích việc phụ thuộc vào các dịch vụ đám mây để kiểm thử hoặc quản lý các dịch vụ tự host của mình, hoặc các API mà tôi có thể truy cập thông qua chúng. Đối với tôi, điều đó đi ngược lại ý nghĩa của việc tự host, và tôi không hiểu tại sao công cụ kiểm thử API nổi tiếng nhất lại giữ kết quả lệnh gọi API của tôi trên đám mây. Bruno có thể không hoàn hảo, dựa trên danh sách các vấn đề trên GitHub, nhưng nó làm được những gì tôi cần, đồng thời vẫn nằm trên phần cứng của tôi, và đó là điều quan trọng. Có thể một ngày nào đó tôi sẽ đạt đến trình độ kiến thức vượt qua giới hạn của Bruno, nhưng cho đến lúc đó, nó là công cụ hoàn hảo để học cách API hoạt động và cách tôi có thể tận dụng chúng cho các tác vụ của mình.
Một chiếc laptop hiển thị giao diện lịch của Nextcloud và Vivaldi, minh họa các dịch vụ tự host
Kết luận:
Bruno thực sự là một làn gió mới trong thế giới công cụ kiểm thử API, đặc biệt với những ai ưu tiên quyền kiểm soát dữ liệu và mô hình tự lưu trữ. Với khả năng hoạt động ngoại tuyến, tích hợp Git liền mạch và phiên bản miễn phí đầy đủ tính năng, Bruno mang đến một giải pháp thay thế mạnh mẽ và đáng tin cậy cho Postman, đặc biệt cho các nhà phát triển và người dùng cá nhân trong cộng đồng tự host dịch vụ. Nó không chỉ đơn thuần là một công cụ kiểm thử, mà còn là một trợ thủ đắc lực giúp bạn hiểu sâu hơn về cách API vận hành và tối ưu hóa quy trình phát triển của mình.
Nếu bạn đang tìm kiếm một công cụ kiểm thử API linh hoạt, an toàn và hoàn toàn nằm trong tầm kiểm soát của mình, Bruno chắc chắn là một cái tên không thể bỏ qua. Hãy thử trải nghiệm và chia sẻ ý kiến của bạn về công cụ tuyệt vời này nhé!
Tài liệu tham khảo:
