Postman giúp nâng cao đáng kể khả năng kiểm thử và tìm hiểu Merchant API bằng cách cung cấp một giao diện thân thiện với người dùng để tạo, gửi và phân tích các yêu cầu HTTP. Bạn có thể dễ dàng tạo và sửa đổi nhiều lệnh gọi API (GET, POST, PUT, DELETE) đến các điểm cuối khác nhau, điều chỉnh các tham số, tiêu đề và nội dung yêu cầu để mô phỏng các tình huống thực tế.
Công cụ này trình bày rõ ràng các phản hồi, bao gồm cả mã trạng thái, tiêu đề và tải trọng, cho phép xác minh nhanh hành vi của API và hỗ trợ gỡ lỗi. Phương pháp có cấu trúc này giúp đẩy nhanh vòng đời phát triển, cải thiện chất lượng API và giúp bạn hiểu rõ hơn về các chức năng cũng như sự phức tạp của Merchant API.
Tổng quan
Để sử dụng bộ sưu tập MAPI Postman trên phiên bản Postman của mình, trước tiên, bạn cần làm theo một số bước để định cấu hình môi trường. Sau đây là hướng dẫn từng bước về cách thực hiện việc đó.
Để biết thêm thông tin về nền tảng này, hãy xem nội dung mô tả về Postman.
1. Cấu hình tài khoản dịch vụ
Bạn sẽ nhận được serviceAccountKey và api_key
- Để biết các bước chi tiết, hãy xem cách sử dụng tài khoản dịch vụ để truy cập API
- Trong Dự án Google Cloud > Thông tin đăng nhập > Tạo thông tin đăng nhập > Tài khoản dịch vụ
- Điền thông tin vào biểu mẫu rồi nhấp vào Tạo và tiếp tục
- Chọn vai trò Chủ sở hữu rồi nhấp vào Tiếp tục
- Nhấp vào Xong
- Để tải khoá JSON xuống, hãy làm theo các bước sau:
- Nhấp vào địa chỉ email Tài khoản dịch vụ vừa tạo (ví dụ: {YOUR_SERVICE_ACCOUNT}@{RANDOM_DOMAIN}.gserviceaccount.com)
- Nhấp vào thẻ Khoá
- Nhấp vào Thêm khoá > Tạo khoá
- Chọn JSON rồi nhấp vào Tạo để tải JSON xuống
CẢNH BÁO: Bạn chỉ có thể tải khoá xuống một lần. Nếu bị mất khoá, bạn cần tạo một khoá mới và xoá khoá này
- Mở Merchant Center
- Trong mục Cài đặt > Quyền truy cập và dịch vụ, hãy nhấp vào Người dùng và quyền truy cập
- Nhấp vào Thêm người rồi dùng mã nhận dạng tài khoản dịch vụ làm địa chỉ email cho người dùng mới.
2. Thiết lập Postman
- Tải tệp JSON mẫu Môi trường Postman xuống
- Tải tệp JSON của bộ sưu tập MAPI Postman xuống
- Đăng nhập vào Postman hoặc tạo một tài khoản mới
- Nhập mẫu Môi trường Postman
- Sao chép toàn bộ JSON vào Environment (Môi trường) > MyAccount (Tài khoản của tôi) > serviceAccountKey
- Sao chép private_key từ JSON vào Environment (Môi trường) > MyAccount (Tài khoản của tôi) > api_key (khoá API) của bộ sưu tập
- Nhập tệp JSON của Bộ sưu tập MAPI Postman
- Chọn môi trường ở góc trên cùng bên phải
3. Đăng ký dành cho nhà phát triển
Liên kết tài khoản Merchant Center với dự án Google Cloud bằng cách đăng ký làm nhà phát triển. Người dùng có vai trò nhà phát triển API sẽ nhận được thông tin liên lạc về API, trong đó có thông báo bắt buộc về dịch vụ, khảo sát dành cho nhà phát triển và các cơ hội.
- Mở Postman > Collections (Bộ sưu tập) > Merchant API Official (Merchant API chính thức)
- Mở accounts_v1 > accounts > accounts.developerRegistration > registerGcp
- Thay thế phần giữ chỗ
{account}trong đường dẫn bằng mã nhận dạng MC của bạn - Thay thế phần giữ chỗ
{email}trong nội dung bằng địa chỉ email của bạn - Nhấp vào Gửi để thực hiện quy trình đăng ký
- Nếu mọi thứ đã được thực hiện đúng cách, bạn sẽ nhận được một phản hồi JSON xác nhận như sau:
json { "name": "accounts/{YOUR_MC_ID}/developerRegistration", "gcpIds": [ "{YOUR_GCP_ID}" ] }
4. Kiểm thử Merchant API trên Postman
- Mở Postman > Collections (Bộ sưu tập) > Merchant API Official (Merchant API chính thức) > accounts_v1 > accounts > list (danh sách)
- Nhấp vào Gửi
- Nếu mọi thứ đã được thực hiện đúng cách, bạn sẽ nhận được một phản hồi JSON xác nhận như sau:
json { "accounts": [ { "name": "accounts/{YOUR_MC_ID}", "accountId": "{YOUR_MC_ID}", "accountName": "{YOUR_MERCHANT_NAME}", "adultContent": false, "timeZone": { "id": "{YOUR_TIMEZONE}" }, "languageCode": "en-US" } ] }