Ngày nay việc trao đổi dữ liệu giữa các hệ thống, giữa client và server là cực kỳ phổ biến. Điều đó dẫn đến khối lượng công việc của các developer liên quan tới RESTful API cũng tăng theo. Việc dùng code để test các API là rất tốn công nên Postman ra đời như là một công cụ giúp giảm bớt gánh nặng cho developer. Hôm này mình sẽ giới thiệu với các bạn về công cụ này
Giới thiệu và cài đặt
Postman ra đời vào năm 2012 bởi Abhinav Asthana với mục đích ban đầu là dự án phụ giúp đơn giản hóa quy trình làm việc API trong thử nghiệm và phát triển. Đến nay, công cụ này đã và đang được 8 triệu người và 400 nghìn công ty sử dụng thường xuyên. Vì sao Postman lại được ưa chuộng như thế?
Bất kỳ ai làm trong lĩnh vực liên quan tới công nghệ cũng có thể dễ dàng tiếp cận và sử dụng Postman mà không cần động tới bất kỳ dòng code nào. Làm chủ được Postman, bạn sẽ thấy việc gọi API không có gì là khó khăn cả.
Postman hỗ trợ tất cả các phương thức của HTTP (GET, POST, PATCH, PUT, DELETE, COPY, HEAD, OPTIONS,…)
Postman cho phép lưu lại lịch sử gọi API, gom nhóm các request thành collection, tạo môi trường, tạo document cho API, dễ dàng share collection/request tới người khác
Để bắt đầu, các bạn truy cập vào đường dẫn: https://www.getpostman.com/downloads/, download phiên bản phù hợp với hệ điều hành của bạn
Hoặc nếu bạn sử dụng trình duyệt Google Chrome, bạn có thể tải Postman như là một extension tại link sau: https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop
Sau khi cài đặt thành công, bạn mở app lên giao diện đăng nhập sẽ hiện ra. Để tiện cho việc đồng bộ dữ liệu thì mình khuyến khích các bạn nên đăng nhập ở bước này.
Các chức năng cơ bản
Postman cung cấp giao diện khá dễ sử dụng. Về cơ bản, chúng ta chỉ cần nắm rõ những chức năng sau là có thể dùng để gọi API tèn tèn rồi:
- Cho phép gửi HTTP Request với các method GET, POST, PUT, PATCH, DELETE,…
- Cho phép gửi dữ liệu dưới dạng form (key-value), text, json, binary,..
- Hiện kết quả trả về dạng TEXT, HTML, XML, JSON
- Hỗ trợ authorization (Oauth1, 2)
- Cho phép thay đổi header của các request
Các bước tạo 1 request cơ bản: chọn method, điền url, nếu cần thiết thì điền thêm các trường ở header, body rồi nhấn Send rồi chờ kết quả trả về ở bên dưới thôi
- Ví dụ với request GET đơn giản
- Với request các request POST, PUT, PATCH,… ta có thể gửi lên các params ở tab Headers, Body
Generate code
Đối với developer, sau khi đã test thành công API trên Postman, vẫn còn một bước quan trọng và tốn kha khá thời gian đó là convert những gì vừa test thành mã code. Thật may, Postman đã xây dựng sẵn chức năng này, người dùng sau khi test xong API trên Postman chỉ cần thêm một vài thao tác đơn giản là có thể lấy được mã code mình mong muốn. Hiện tại Postman đã hỗ trợ generate ra khá nhiều ngôn ngữ lập trình: C, C#, Java, PHP, Go, Javascript, Python,… Các bạn chỉ cần làm theo các bước: Test thử API như bình thường, nếu như API chạy tốt, bạn bấm vào nút “Code” ở bên phải màn hình, rồi chọn ngôn ngữ mà bạn muốn generate code. Đến đây code đã được show ra, việc của ta chỉ cần bôi đen đoạn code muốn chạy rồi copy hoặc bấm vào “Copy to Clipboard” là xong.
Collections và Share collection
Để tập trung những API liên quan tới nhau, ví dụ những API cùng 1 project chẳng hạn, Postman cho phép gom nhóm chúng vào 1 collection, như vậy sẽ dễ dàng cho việc quản lý, tìm kiếm hơn. Để thêm 1 API vào collection, các bạn tiến hành các bước sau:
- Click vào nút “Save /Save as” ở bên phải nút “Send” hoặc bấm Ctrl/command + S
- Nhập tên, mô tả cho request ở popup vừa hiện lên
- Chọn collection sẽ chứa request, có thể tạo một collection mới ở bước này
- Bấm “Save”
Ngoài ra, nếu bạn muốn share collection cho người khác, mà không muốn mất công tạo collection và các request từ đầu, Posman cung cấp chức năng share collection. Có khá nhiều cách để làm việc này như: export collection ra file rồi gửi cho người đó import vào, Team sharing (mất phí), Embed Button,… nhưng mình sẽ giới thiệu tới mọi người cách đơn giản mà mình hay dùng nhất đó là: Get Collection Link. Các bạn thực hiện theo thứ tự ở hình bên dưới nhé
Thực hiện các bước ở trên là các bạn đã lấy được link của collection, với link này ta có thể test collection ở bất cứ máy nào bằng cách chạy link này trên trình duyệt hoặc import link này trong Postman
Tạo biến môi trường
Đây là chức năng mình thấy được sử dụng khá nhiều và hữu ích. Thông thường khi phát triển API ta sẽ làm việc trên 3 môi trường: dev/local, staging, production. Ví dụ: sau khi test xong tất cả request ở môi trường local, ta tiến hành deploy code và test trên môi trường staging. Việc cần làm tiếp theo là đổi url ở tất cả request về môi trường staging, khá mất công phải không nào. Postman cung cấp một giải pháp đó là ta sẽ tạo ra các biến môi trường và khi chuyển đổi môi trường để test API thì ta chỉ cần chuyển đổi environment sang cái tương ứng. Cách sử dụng chức năng này như sau: Ở góc trên bên phải của màn hình chính ta chọn hình bánh răng và chọn chức năng “Manage Environments”. Trong màn hình này ta có thể thêm hoặc sửa một Environment. Ví dụ ở đây mình đã có environment là Local và mình thêm biến môi trường là projecta_url, biến dùng cho url mình sẽ đặt theo dạng {tên project}_url. Như hình dưới đây:
Tạo thêm các Environments tương ứng ví dụ là Staging và Production và đổi sang các url tương ứng với nó. Sau đấy trong mỗi request ta chỉ cần khai báo biến {{projecta_url}} và chọn môi trường mà bạn muốn test. Ví dụ ở môi trường Local: {{projecta_url}}/get_all sẽ được Postman hiểu là: http://projecta.test/get_all
Kết luận
Trên đây là những chức năng cơ bản và một vài chức năng nâng cao của Postman. Hi vọng sau bài viết này, việc kiểm thử và phát triển API của các bạn sẽ dễ dàng hơn với Postman. Bạn có bất kỳ thắc mắc nào cứ để lại bên dưới hoặc liên hệ trực tiếp với mình nhé (Skype: diemngo166). Mình sẽ cố gắng giải đáp ^_^
(4 lượt thả tim)
Loading...
