v2.product.get_item_list
GET /api/v2/product/get_item_list
Use this call to get a danh sách items.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/product/get_item_list
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được gán 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 để chỉ định thời gian 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. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id 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ả |
|---|---|---|---|---|
| offset | int64 | True | 0 | Specifies the starting entry of data to return in the current call. Default is 0. if data is more than one page, the offset can be some entry to start next call. |
| page_size | int64 | True | 10 | the size of one page.Max=100 |
| update_time_from | timestamp | False | 1611311600 | The update_time_from and update_time_to fields specify a date range for retrieving orders (based on the item update time). The update_time_from field is the starting date range. |
| update_time_to | timestamp | False | 1611311631 | The update_time_from and update_time_to fields specify a date range for retrieving orders (based on the item update time). The update_time_to field is the ending date range |
| item_status | string[] | True | ["NORMAL"] | NORMAL/BANNED/UNLIST/REVIEWING/SELLER_DELETE/SHOPEE_DELETE If you want to search multiple status, please upload the url like this: item_status=NORMAL&item_status=BANNED |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. | |
| message | string | Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. | |
| warning | string | Indicate waring details if hit waring. Empty if no waring happened. | |
| request_id | string | 7b9da0c6926642199c33ee9dd3a266f5 | The identifier for an API request for error tracking |
| response | object | ||
| item | object[] | danh sách item info with item_id/ item_status/ update_time | |
| item_id | int64 | 2500139861 | Shopee's mã định danh duy nhất for an item. |
| item_status | string | NORMAL | Enumerated type that defines the current status of the item. Các giá trị áp dụng: NORMAL, BANNED, UNLIST, REVIEWING, SELLER_DELETE, SHOPEE_DELETE. |
| update_time | timestamp | 1608128470 | The update time of item. |
| tag | object | ||
| kit | boolean | true | Indicate if the item is kit item. |
| total_count | int64 | 10 | total count of all items |
| has_next_page | boolean | true | This is to indicate whether the item list is more than one page. If this value is true, you may want to continue to check next page to retrieve the rest of items. |
| next_offset | int64 | 10 | if has_next_page is true, this value need set to next request.offset |
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/product/get\_item\_list?page\_size=10&item\_status=NORMAL&offset=0&partner\_id=partner\_id&access\_token=access\_token×tamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631&sign=sign&shop\_id=shop\_id") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token&item\_status=NORMAL&offset=0&page\_size=10&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request GET 'https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token×tamp=timestamp&update\_time\_from=1611311600&page\_size=10&item\_status=NORMAL&offset=0&partner\_id=partner\_id&update\_time\_to=1611311631&sign=sign&shop\_id=shop\_id' import requests url = "https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token&item\_status=NORMAL&offset=0&page\_size=10&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631" payload={} headers = { } response = requests.request("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)
, "update_time": 1608128470 } ], "total_count": 19, "has_next_page": true, "next_offset": 10 } }