v2.global_product.get_global_item_list
GET /api/v2/global_product/get_global_item_list
Lấy danh sách ID sản phẩm toàn cầu. Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/get_global_item_list
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ả |
|---|---|---|---|---|
| offset | string | False | AAAAFA== | Xác định mục bắt đầu của dữ liệu trả về. Mặc định là null. 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. Giới hạn từ [1, 50]. |
| update_time_from | timestamp | False | 1611311600 | Trường update_time_from và update_time_to xác định khoảng thời gian để lấy đơn hàng (dựa theo thời gian cập nhật sản phẩm). update_time_from là mốc bắt đầu. |
| update_time_to | timestamp | False | 1611311631 | Trường update_time_from và update_time_to xác định khoảng thời gian để lấy đơn hàng (dựa theo thời gian cập nhật sản phẩm). update_time_to là mốc kết thúc. |
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 | 79121bb8ce90449e81743a15067410f3 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | ||
| global_item_list | object[] | ||
| global_item_id | int | 2300146833 | Mã định danh duy nhất của Shopee cho một sản phẩm toàn cầu. |
| update_time | timestamp | 1608967817 | Thời điểm cập nhật gần nhất của sản phẩm, chẳng hạn thay đổi giá/tồn kho. |
| total_count | int | 826 | Tổng số sản phẩm toàn cầu. |
| has_next_page | boolean | true | Cho biết danh sách sản phẩm 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. |
| offset | string | AAAAFA== | 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. |