Postman là một App Extensions, cho phép làm việc với các API, nhất là REST, giúp ích rất nhiều cho việc testing. Hỗ trợ tất cả các phương thức HTTP (GET, POST, PUT, DELETE, OPTIONS, HEAD …) Postman cho phép lưu lại các lần sử dụng. Sử dụng cho cá nhân hoặc team lớn.
Là một công cụ mã nguồn mở (Open Source), Postman có thể dễ dàng tải về. Truy cậo trang chủ link và chọn nền tảng muốn cài đặt như cho Mac, Windows hoặc Linux rồi tiến hành cài đặt.
Để bắt đầu làm quen với việc gởi một request căn bản, mình sẽ có một requirement như sau.
Thường trước khi thực hiện kiểm thử API chúng ta nên có đầy đủ thông tin của API cần test giống như bảng này.
This API will retrieving all employees data from the table and return information that included name, salary and age.
| URL | https://sangbui.com/api/v1/employees |
| Method | GET |
| URL Params | <none> |
| Header | Content-Type: application/jsonAuthorization: Basic d2ViX2FwcDpjaGFuZ2VpdA== |
| Data Params | <none> |
| Success Response | Code: 200 OKContent:[{“id”: “<id>”,“employee_name”: “<name>”,“employee_salary”: “<salary>”,“employee_age”: “<age>”},{“id”: “<id>”,“employee_name”: “<name>”,“employee_salary”: “<salary>”,“employee_age”: “<age>”}] |
| Error Response | 404 Not Found (Incorrect path)401 Unauthorized (Incorrect permission) |
| Sample Call | <none> |
| Notes | <none> |
URL: Đây là địa chỉ URL (endpoint) mà request sẽ gởi đi
Method: Phương thức của request, như trong bảng yêu cầu thì phương thức được gởi đi là phương thức GET (ngoài ra còn nhiều phương thức khác như POST, PUT, DELETE…)
URL Params: Tham số truyền thêm vào URL, hiện tại yêu cầu là không cần tham số nào khác trên URL
Header: Thông tin về headers của một request, hiện tại chúng ta có 2 khoá là “Content-Type” và “Authorization”
Data Params: Chúng ta không cần data parameters trong phương thức GET
Success Response: Kết quả khi request được gởi thành công (gồm code và content/body)
Error Response: Kết quả khi request được gởi thất bại (response code khi gặp lỗi).
Vậy là chúng ta đã hiểu requirement và có những thông tin cần thiết, bây giờ chúng ta sẽ tiến hành tạo request đó trên Postman.
Trên Header Bar, các bạn chọn New. Sau đó chọn Request
Nhập các thông tin về request.
Sau khi tạo mới một request, các bạn chuyển qua phần Builder để nhập các thông tin cần thiết như hình bên dưới.
Kết quả:
Chúng ta có thể xem kết quả ở mục Status. Hiện tại Status: 200 OK cho thấy request đã được gởi thành công. Ngoài ra có thể kiểm tra thêm ở phần response body bên dưới để xem kết quả, danh sách dữ liệu trả về.
Vậy nếu thông tin nhập không đúng thì kết quả sẽ ra sao?
Mình sẽ thử sửa lại giá trị chỗ Authorization và gởi lại request.
Kết quả trả về là 401 Unauthorized (không thành công) và có thông báo “Please check the authorization“.
Với mỗi lỗi khác nhau sẽ có một response code / body khác nhau, các bạn nên làm rõ yêu cầu của khách hàng trong từng trường hợp.
Đến đây các bạn đã hoàn thành được các bước tạo request, nhập các thông tin cần thiết và gởi đi, cũng như có thể xem và đọc được kết quả trả về từ Postman.
Link tham khảo :
https://viblo.asia/p/huong-dan-su-dung-postman-cho-test-api-aWj53Lb1K6m
You need to login in order to like this post: click here
YOU MIGHT ALSO LIKE
