v2.global_product.get_shop_publishable_status
GET /api/v2/global_product/get_shop_publishable_status
Lấy danh sách cửa hàng có thể đăng bán cho sản phẩm toàn cầu theo phân trang.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/get_shop_publishable_status
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi 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 mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| merchant_id | int | 1 | Mã định danh duy nhất của Shopee cho một merchant. Bắt buộc cho mọi yêu cầu cấp merchant (người dùng CB CNSC gọi các API liên quan đến sản phẩm toàn cầu). |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, merchant_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết: 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ả |
|---|---|---|---|---|
| global_item_id | int | True | 3000141126 | ID của sản phẩm toàn cầu. |
| offset | int | True | 0 | Xác định mục bắt đầu của dữ liệu trả về. Mặc định là 0. Nếu dữ liệu nhiều hơn một trang, có thể dùng offset để bắt đầu lần gọi tiếp theo. |
| page_size | int | True | 10 | Kích thước một trang. Tối đa = 100. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| warning | string | Thông báo cảnh báo. | |
| request_id | string | 98eae35efff24dd0974c21a847127184 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| shop_publishable_status_list | object[] | Chi tiết các cửa hàng có thể đăng bán. | |
| shop_id | int | 1000567 | ID cửa hàng có thể đăng bán. |
| region | string | TW | Khu vực của cửa hàng đã đăng. |
| shop_publishable_status | boolean | true | Trạng thái có thể đăng bán của cửa hàng. true nghĩa là cửa hàng có thể đăng bán, false nghĩa là không thể đăng bán. |
| unpublishable_reason | string | The shop is under penalty | Lý do không thể đăng bán. Nếu cửa hàng có thể đăng bán, trường này sẽ để trống. |
| has_next_page | boolean | true | Cho biết danh sách có nhiều hơn một trang không. Nếu giá trị này là true, bạn nên tiếp tục kiểm tra trang tiếp theo. |
| next_offset | int | 1 | Nếu has_next_page là true, giá trị này cần được đặt vào request.offset cho lần gọi tiếp theo. |