v2.public.get_merchants_by_partner
GET /api/v2/public/get_merchants_by_partner
Dùng API này để lấy thông tin cơ bản của các merchant đã ủy quyền cho đối tác.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/public/get_merchants_by_partner
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| page_size | int | False | 1 | Each result set is returned as a page of entries. Use the "page_size" filters to control the maximum number of entries to retrieve per page (i.e., per call), and the "page_no" to start next call. This integer value is used to specify the maximum number of entries to return in a single "page" of data. |
| page_no | int | False | 1 | Specifies the page number of data to return in the current call. Starting from 1. if data is more than one page, the page_no can be some entry to start next call. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| authed_merchant_list | object[] | Danh sách merchant đã ủy quyền cho đối tác. | |
| region | string | SG | Khu vực merchant |
| merchant_id | int | 1 | Mã định danh duy nhất của Shopee cho một merchant. |
| auth_time | timestamp | 123 | Thời gian merchant được ủy quyền cho đối tác. |
| expire_time | timestamp | 12312 | Dùng trường này để cho biết ngày hết hạn ủy quyền merchant. |
| request_id | string | asdasq | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| more | boolean | false | Cho biết danh sách có nhiều hơn một trang. Nếu là true, hãy tiếp tục kiểm tra trang tiếp theo để lấy dữ liệu còn lại. |
| error | string | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. |