Skip to main content

5. Postman tool

Cài đặt Postman trên máy tính​

  1. Truy cập vào trang chủ của Postman tại https://www.postman.com/downloads.
  2. Chọn phiên bản phù hợp với hệ điều hành của bạn và tải xuống file cài đặt.
  3. Sau khi tải xuống, mở file cài đặt và bắt đầu quá trình cài đặt bằng cách nhấn vào nút "Install".
  4. Sau khi cài đặt thành công, mở Postman bằng cách tìm kiếm trong danh sách ứng dụng hoặc chọn biểu tượng Postman trên màn hình Desktop.
  5. Sau khi cài đặt thành công, bạn có thể bắt đầu sử dụng Postman để gửi các yêu cầu HTTP, kiểm thử API, chạy các bộ kiểm thử tự động và quản lý các biến và môi trường. Bạn có thể tham khảo tài liệu hướng dẫn và tài nguyên trên trang chủ của Postman để biết thêm thông tin chi tiết về cách sử dụng Postman.

Thực hành với POSTMAN​

Đăng nhập để lấy access_token​

{
  "username": "tungnt@softech.vn",
  "password": "123456789"
}
  • Response:
{
  "loggedInuser": {
    "id": 1,
    "email": "tungnt@softech.vn",
    "isActive": true,
    "userRoles": [
      ...
    ]
  },
  "access_token": "...",
  "refresh_token": "..."
}

Sử dụng access_token để gọi các API khác​

Gắn access_token vào các request có yêu cầu xác thực​

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Send GET request​

Để gọi một GET request trong Postman, làm theo các bước sau:

  1. Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
  2. Chọn phương thức "GET" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu POST.
  3. Nhấn vào nút "Send" để gửi yêu cầu GET. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
  4. Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
tip

Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Ví dụ:

Send GET request with query params​

Để gọi một GET request trong Postman để lấy thông tin của một category có ID là 7, làm theo các bước sau:

  1. Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
  2. Chọn phương thức "GET" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu GET để lấy thông tin category. Ví dụ: https://server.softech.cloud/online-shop/categories/7 để lấy thông tin category có ID là 7.
  3. Nhấn vào nút "Send" để gửi yêu cầu GET. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
  4. Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
tip

Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Ví dụ:

Send POST request​

Để gọi một POST request trong Postman, làm theo các bước sau:

  1. Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
  2. Chọn phương thức "POST" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu POST.
  3. Chọn tab "Body" trong Postman và chọn loại định dạng dữ liệu mà bạn muốn gửi. Ví dụ: Raw, JSON, x-www-form-urlencoded, hay form-data.
  4. Nhập dữ liệu của yêu cầu trong phần thân yêu cầu (request body). Nếu bạn chọn "Raw", bạn có thể nhập dữ liệu trực tiếp vào ô văn bản, hoặc nếu bạn chọn một loại định dạng khác như JSON hoặc form-data, bạn có thể sử dụng các ô đầu vào để thêm dữ liệu.
  5. Nhấn vào nút "Send" để gửi yêu cầu POST. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
  6. Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
tip

Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Ví dụ:

{
  "name": "New Product",
  "description": "New Desc"
}
  • Response status
    • 201: Created
    • 500: Internal Server Error

Send PATCH request​

Để gọi một PATCH request trong Postman, làm theo các bước sau:

  1. Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
  2. Chọn phương thức "PATCH" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu PATCH. Ví dụ: https://server.softech.cloud/online-shop/categories/1 để cập nhật thông tin category có ID là 1.
  3. Chọn tab "Body" trong Postman và chọn loại định dạng dữ liệu mà bạn muốn gửi. Ví dụ: Raw, JSON, x-www-form-urlencoded, hay form-data.
  4. Nhập dữ liệu của yêu cầu trong phần thân yêu cầu (request body). Nếu bạn chọn "Raw", bạn có thể nhập dữ liệu trực tiếp vào ô văn bản, hoặc nếu bạn chọn một loại định dạng khác như JSON hoặc form-data, bạn có thể sử dụng các ô đầu vào để thêm dữ liệu.
  5. Nhấn vào nút "Send" để gửi yêu cầu PATCH. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
  6. Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
tip

Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Ví dụ:

{
  "description": "New Desc"
}
  • Response status
    • 200: Cập nhật thành công
    • 400: id không hợp lệ
    • 410: Không tìm thấy category

Send DELETE request​

Để gọi một DELETE request trong Postman để xóa một category có id = 34, làm theo các bước sau:

  1. Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
  2. Chọn phương thức "DELETE" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu DELETE để xóa category. Ví dụ: https://server.softech.cloud/online-shop/categories/34 để xóa category có ID là 34.
  3. Nhấn vào nút "Send" để gửi yêu cầu DELETE. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
  4. Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
tip

Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:

  • Chọn tab Auth
  • Chọn Type: Bearer Token
  • Dán access_token từ [response body] của [login request] vào ô token

Ví dụ: