Cách thu thập các gói dữ liệu API bằng Postman

Chào mọi người, tôi là Sky blue, một lập trình viên mới vào nghề! Gần đây, tôi có nhiều cơ hội tiếp xúc với phát triển và kiểm thử API, nên bắt đầu sử dụng Postman. Postman thực sự tiện lợi cho việc debug API, kiểm tra phản hồi, v.v. Nhưng đôi khi, bạn có bao giờ nghĩ "Tôi muốn thử yêu cầu API mà tôi thấy trên trình duyệt này bằng Postman" không?

Ban đầu, tôi nhập thủ công các tham số và header vào Postman, nhưng việc này khá phiền phức... Đặc biệt với các yêu cầu phức tạp, tôi gần như muốn khóc. Lúc đó, tôi nghe nói "À, có vẻ như có thể xuất ra cURL rồi nhập vào Postman!", và tôi đã thử ngay.

Trong bài viết này, tôi sẽ giới thiệu cách nhập cURL vào Postman lúc đó, và một phương pháp dễ dàng hơn nhiều mà tôi đã rất sốc khi biết đến.

Tại sao lại muốn thử yêu cầu API của trình duyệt bằng Postman?

Đây là điều khá phổ biến, tôi nghĩ vậy:

• Muốn kiểm tra hành vi của API mà ứng dụng đang chạy trên trình duyệt gọi
• Muốn tái tạo yêu cầu API xảy ra khi thực hiện một thao tác cụ thể để debug
• Muốn thử yêu cầu API mà người khác đã gọi trên trình duyệt và chia sẻ cho mình

Trong những trường hợp như vậy, việc đưa yêu cầu mà bạn thấy trong công cụ phát triển của trình duyệt vào Postman sẽ giúp công việc hiệu quả hơn rất nhiều.

Các bước nhập cURL vào Postman

Đầu tiên, hãy xem cách tôi đã thử với Postman. Biết cách này cũng tiện lợi.

Bước 1: Sao chép cURL trong công cụ phát triển của trình duyệt

Đây không phải là tính năng của Postman, nhưng là bước đầu tiên để chụp gói API.

1. Đầu tiên, mở trang web mà yêu cầu API bạn muốn kiểm tra xảy ra trong trình duyệt.
2. Nhấn phím F12 trên bàn phím để mở công cụ phát triển. (Trên Mac là Option + Command + I, v.v.)
3. Chuyển sang tab "Network" trong công cụ phát triển.
4. Thao tác trên trang để tạo ra yêu cầu API mong muốn. Các yêu cầu sẽ hiển thị thành danh sách trong tab Network.
5. Tìm yêu cầu mong muốn, nhấp chuột phải và chọn "Copy" → "Copy as cURL (bash)". Thao tác này sẽ sao chép lệnh cURL của yêu cầu đó vào clipboard.

Bước 2: Nhập cURL vào Postman

Bây giờ, hãy đưa cURL đã sao chép vào Postman.

1. Mở Postman.
2. Nhấp vào nút "Import" ở phía trên bên trái màn hình.
3. Chọn tab "Paste Raw Text" và dán lệnh cURL vừa sao chép vào.
4. nhưng về cơ bản chỉ cần nhấp "Import Into Collection" là được.
5. Bây giờ, yêu cầu API đã sao chép sẽ được nhập vào Collection trong Postman.

Bước 3: Gửi yêu cầu và xem kết quả trong Postman

Sau khi nhập xong, chỉ cần thực thi trong Postman.

1. Chọn yêu cầu đã được nhập.
2. Nhấp vào nút "Send"!
3. Trong tab "Response" ở phía dưới màn hình, phản hồi từ API sẽ hiển thị. Bạn có thể kiểm tra chi tiết mã trạng thái, body phản hồi, header, v.v.

Ừm, vậy là tôi đã tái tạo được yêu cầu mà tôi thấy trên trình duyệt bằng Postman! ... Lúc đầu, tôi rất ấn tượng, nhưng thành thật mà nói, tôi cảm thấy thao tác "nhập" này hơi phiền phức. Đặc biệt khi muốn thử nhanh nhiều yêu cầu khác nhau, tôi nghĩ liệu có cách nào mượt mà hơn không.

Ồ, cách này dễ hơn hẳn! Phương pháp chụp gói API (API Capture) đơn giản hơn

Việc nhập cURL vào Postman cũng tiện lợi, nhưng thực ra tôi đã tìm thấy một phương pháp trực quan và đơn giản hơn nhiều. Đó là sử dụng Apidog, công cụ mà gần đây tôi dùng chính cho việc phát triển API.

Với Apidog, không có cảm giác cứng nhắc như nhập vào Collection trong Postman, mà bạn có thể dễ dàng đọc cURL và thử yêu cầu ngay lập tức.

Các bước nhập cURL vào Apidog

Cách làm đơn giản hơn Postman.

1. Mở ApApidogmở một dự án có sẵn hoặc tạo một dự án mới. (Quản lý dự án bằng Apidog cũng tiện lợi lắm)
2. Nhấp vào nút "Import" bên cạnh nút "+" ở phía trên bên trái màn hình.
3. Chọn "cURL" trong các tùy chọn nhập.
4. Giống như với Postman, dán lệnh cURL đã sao chép từ trình duyệt vào vùng văn bản.
5. Nhấp vào nút "Xác nhận"!

Chỉ vậy thôi! Không có bước chọn Collection hay gì đó như Postman. Chỉ cần dán và xác nhận.

Gửi yêu cầu và xem kết quả trong Apidog

Sau khi đọc cURL, màn hình yêu cầu sẽ mở ra ngay lập tức.

1. Kiểm tra nội dung của yêu cầu đã được đọc (URL, phương thức, header, body, v.v.).
2. Nhấp vào nút "Send"!
3. Phản hồi sẽ hiển thị ở phía dưới màn hình. Giống như Postman, bạn có thể xem mã trạng thái, body, header, v.v.

Bạn thấy sao? So với các bước nhập của Postman, Apidog có ít bước hơn đáng kể và trực quan hơn, đúng không? Chỉ với 3 bước: "Sao chép cURL trên trình duyệt" → "Dán vào Apidog" → "Gửi", bạn có thể thử API ngay lập tức.

Với Postman, việc yêu cầu đã nhập được lưu vào Collection là một điểm tốt, nhưng khi chỉ muốn "thử nhanh một chút", sự tiện lợi của Apidog thực sự hữu ích.

Tóm lại: Postman và Apidog, có lẽ việc sử dụng linh hoạt là quan trọng

Lần này, tôi đã giới thiệu cách nhập cURL (chụp gói API) bằng Postman và Apidog.

Postman là công cụ kinh điển đã được sử dụng lâu năm và có nhiều tính năng phong phú. Tôi cảm thấy nó vẫn mạnh mẽ khi muốn xây dựng kỹ lưỡng, chẳng hạn như quản lý API bằng Collection và tự động hóa kiểm thử.

Mặt khác, Apidog, ngoài sự tiện lợi khi nhập cURL mà tôi đã giới thiệu lần này, còn là một công cụ tất cả trong một chứa đựng đầy đủ các chức năng cần thiết cho phát triển API, từ thiết kế API, tự động tạo tài liệu, chức năng Mock server, đến chức năng kiểm thử. Đặc biệt nếu làm việc nhóm để phát triển API, việc quản lý tất cả trong Apidog là một lợi ích lớn. Nó cũng hỗ trợ tiếng Nhật tốt và giao diện người dùng dễ hiểu, nên tôi cũng khuyên dùng cho người mới bắt đầu.

Cá nhân tôi cảm thấy, khi muốn kiểm tra nhanh hành vi của API hoặc thử cURL mà người khác gửi cho, tôi dùng Apidog. Khi muốn ngồi xuống xây dựng bộ kiểm thử API hoặc sắp xếp Collection, tôi dùng Postman. Có lẽ việc sử dụng linh hoạt như vậy là tốt.

Mọi người cũng hãy tìm công cụ phù hợp với phong cách phát triển của mình và nâng cao hiệu quả phát triển/kiểm thử API nhé!