快工助手跨境电商知识与商机助手
快工云仓服务介绍

v2.global_product.get_global_item_info

Shopee 官方资料 · Shopee Open Platform 接口参考 · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存，可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.api_reference
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/developer

资料正文

§1 v2.global_product.get_global_item_info

Get global item info.Only for China mainland sellers and Korean sellers.

#

§2 Overview

Overview

FieldValue
ModuleGlobalProduct
API typeMerchant
HTTP methodGET
Path/api/v2/global_product/get_global_item_info
Production URLhttps://partner.shopeemobile.com/api/v2/global_product/get_global_item_info
Sandbox URLhttps://partner.test-stable.shopeemobile.com/api/v2/global_product/get_global_item_info
Rate limit[0, 0, 0]
PermissionERP System; Seller In House System; Product Management; Swam ERP
#

§3 Request parameters

Request parameters

NameTypeRequiredSampleDescription
global_item_id_listint64YesGlobal item id list. Length limit is [1,20].
#

§4 Response parameters

Response parameters

NameTypeRequiredSampleDescription
errorstringIndicate error type if hit error. Empty if no error happened.
messagestringIndicate error details if hit error. Empty if no error happened.
warningstringWarning massage.
request_idstring6f235f4a343e4feb8a9ed74c439f6663The identifier of the API request for error tracking.
responseobject
response.global_item_listobject[]
response.global_item_list.global_item_idint6427001415Shopee's unique identifier for an global item.
response.global_item_list.global_item_namestringMY OLD NEW two tier model item 5Name of the global item.
response.global_item_list.descriptionstringMY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model itemDescription of the global item.
response.global_item_list.global_item_skustringsku1An global item SKU (stock keeping unit) is an identifier defined by a seller, sometimes called parent SKU. Item SKU can be assigned to an item in Shopee Listings.
response.global_item_list.global_item_statusstringNORMALThe current status of the item. You can only query global product with normal status, otherwise api will return error.
response.global_item_list.create_timetimestamp1605247451Timestamp that indicates the date and time that the global item was created.
response.global_item_list.update_timetimestamp1605247451Timestamp that indicates the last time that there was a change in value of the global item.
response.global_item_list.stock_infoobject[]If the item has models, this field will not be returned, please get it through get_model_list api.
response.global_item_list.stock_info.stock_typeint322The stock type.
response.global_item_list.stock_info.stock_location_idstringKRZlocation_id of the stock.
response.global_item_list.stock_info.normal_stockint3244The normal stock quantity of the variation in the listing currency.
response.global_item_list.stock_info.reserved_stockint320The reserved stock quantity of the variation in the listing currency.
response.global_item_list.price_infoobject[]If the item has models, price_info will not be returned. Please get the price of each model through the get_global_model_list api.
response.global_item_list.price_info.currencystringCNYThe three-digit code representing the currency unit used for the item in Shopee Listings.
response.global_item_list.price_info.original_pricefloat100.1The original price of the item in the listing currency.
response.global_item_list.price_info.sip_item_pricefloat11.11SIP item price.
response.global_item_list.price_info.sip_item_price_sourcestringautosource of sip' price. ( auto or manual).
response.global_item_list.imageobject
response.global_item_list.image.image_id_liststring[]["bf5a022e4624ff6c01ef151001762db7", "1a689fb0124a6d8762761f3ae13815ed"]List of image url.
response.global_item_list.image.image_url_liststring[]["https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7", "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed"]List of image id.
response.global_item_list.weightstring"1.1"The weight of this global item, the unit is KG.; If set the weight of global models under this item, will return the max weight of all global models during the switching period to ensure system compatibility, please switch to call v2.global_product.get_global_model_list to get the weight of models.
response.global_item_list.dimensionobjectThe dimension of this global item.; If set the dimension of global models under this global item, will return the dimension with largest volume calculated by heightlengthwidth during the switching period to ensure system compatibility, please switch to call v2.global_product.get_global_model_list to get the dimension of models.
response.global_item_list.dimension.package_lengthint3211The length of package for this global item, the unit is CM.
response.global_item_list.dimension.package_widthint3211The width of package for this global item, the unit is CM.
response.global_item_list.dimension.package_heightint3211The height of package for this global item, the unit is CM.
response.global_item_list.pre_orderobjectIf set the DTS of global models under this item, will return the max DTS of all global models during the switching period to ensure system compatibility, please switch to call v2.global_product.get_global_model_list to get the DTS of models.
response.global_item_list.pre_order.days_to_shipint323Days to ship.
response.global_item_list.size_chartstring1a689fb0124a6d8762761f3ae13815edUrl of size chart image.
response.global_item_list.conditionstringNEWIs it second-hand.
response.global_item_list.has_modelbooleantrueDoes it contain model.
response.global_item_list.videoobject
response.global_item_list.video.video_urlstring1a689fb0124a6d8762761f3ae13815edUrl of video.
response.global_item_list.video.thumbnail_urlstring7432bfa3713715bc1f88f4025241eb6dThumbnail of video.
response.global_item_list.video.durationint32100Duration of video.
response.global_item_list.category_idint322347462Shopee's unique identifier for a category.
response.global_item_list.brandobject
response.global_item_list.brand.brand_idint326238Id of brand.
response.global_item_list.brand.original_brand_namestringNikeOriginal name of brand.
response.global_item_list.attribute_listobject[]
response.global_item_list.attribute_list.attribute_idint324811The Identify of each category.
response.global_item_list.attribute_list.original_attribute_namestringBrand: L2 Default [14644]The name of each attribute.
response.global_item_list.attribute_list.attribute_value_listobject[]
response.global_item_list.attribute_list.attribute_value_list.value_idint321047251Unique identifier for value of this item attribute.
response.global_item_list.attribute_list.attribute_value_list.original_value_namestring10Value name of this item attribute.
response.global_item_list.attribute_list.attribute_value_list.value_unitstringkgValue unit of this item attribute.
response.global_item_list.description_infoobjectNew description field.New description field. Only whitelist sellers can use it. If you use the field, please upload the description_type=extended otherwise api will return error. If you don't use this field, you don't need to upload the description_type or upload description_type=normal
response.global_item_list.description_info.extended_descriptionobjectIf description_type is extended , Description information will be returned through this field.
response.global_item_list.description_info.extended_description.field_listobject[]Field of extended description
response.global_item_list.description_info.extended_description.field_list.field_typestringType of extended description field: values: See Data Definition- description_field_type (text , image).
response.global_item_list.description_info.extended_description.field_list.textstringIf field_type is text, text information will be returned through this field.
response.global_item_list.description_info.extended_description.field_list.image_infoobjectIf field_type is image, image url will be returned through this field.
response.global_item_list.description_info.extended_description.field_list.image_info.image_idstringImage id.
response.global_item_list.description_info.extended_description.field_list.image_info.image_urlstringImage url.
response.global_item_list.description_typeobjectType of description : values: See Data Definition- description_type (normal , extended).
response.global_item_list.is_fulfillment_by_shopeebooleanwhether item is fulfillment by shopee
response.global_item_list.size_chart_idint64size_chart 模板ID
#

§5 Common parameters

Common parameters

NameTypeRequiredSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
merchant_idint1Shopee’s unique identifier for a merchant. Required for all merchant level requests(CB CNSC user calling global product related APIs).
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, merchant_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2
#

§6 Request samples

Request samples

#

§7 Java

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/global_product/get_global_item_info?timestamp=timestamp&global_item_id_list=2700141503,2700141501,2700141500,2700141449,2700141448,2700141447,2700141319,2700141318,2700141317&sign=sign&merchant_id=merchant_id&partner_id=partner_id&access_token=access_token")
.asString();
#

§8 PHP

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/global_product/get_global_item_info?access_token=access_token&global_item_id_list=2700141503,2700141501,2700141500,2700141449,2700141448,2700141447,2700141319,2700141318,2700141317&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp',
  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;
#

§9 cURL

cURL

curl --location --request GET 'https://partner.shopeemobile.com/api/v2/global_product/get_global_item_info?partner_id=partner_id&access_token=access_token&timestamp=timestamp&global_item_id_list=2700141503,2700141501,2700141500,2700141449,2700141448,2700141447,2700141319,2700141318,2700141317&sign=sign&merchant_id=merchant_id'
#

§10 Python

Python

import requests

url = "https://partner.shopeemobile.com/api/v2/global_product/get_global_item_info?access_token=access_token&global_item_id_list=2700141503,2700141501,2700141500,2700141449,2700141448,2700141447,2700141319,2700141318,2700141317&merchant_id=merchant_id&partner_id=partner_id&sign=sign&timestamp=timestamp"

payload={}
headers = {

}
response = requests.request("GET",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)
#

§11 Response sample

Response sample

#

§12 JSON

JSON

{
    "error": "",
    "message": "",
    "warning": "",
    "request_id": "6f235f4a343e4feb8a9ed74c439f6663",
    "response": {
        "global_item_list": [
            {
                "global_item_id": 2700141503,
                "global_item_name": "MY OLD NEW two tier model item 5",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141501,
                "global_item_name": "MY OLD NEW two tier model item 9",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141500,
                "global_item_name": "MY OLD NEW default no model item",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "stock_info": [
                    {
                        "stock_type": 2,
                        "stock_location_id": "KRZ",
                        "normal_stock": 44,
                        "reserved_stock": 0
                    }
                ],
                "price_info": [
                    {
                        "currency": "CNY",
                        "original_price": 0,
                        "sip_item_price":0,
                        "sip_item_price_source":"auto"
                    }
                ],
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": false
            },
            {
                "global_item_id": 2700141449,
                "global_item_name": "MY OLD NEW one tier model item 8",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "906948af93fcc0b36efa60983c200987"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/906948af93fcc0b36efa60983c200987"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141448,
                "global_item_name": "MY OLD NEW two tier model item 8",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141447,
                "global_item_name": "MY OLD NEW two tier model item 6",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141319,
                "global_item_name": "MY OLD NEW one tier model item 1",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "906948af93fcc0b36efa60983c200987"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/906948af93fcc0b36efa60983c200987"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141318,
                "global_item_name": "MY OLD NEW two tier model item 7",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141317,
                "global_item_name": "MY OLD NEW one tier model item 0",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "906948af93fcc0b36efa60983c200987"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/906948af93fcc0b36efa60983c200987"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true
            },
            {
                "global_item_id": 2700141316,
                "global_item_name": "MY OLD NEW two tier model item 2",
                "description": "MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item",
                "global_item_sku": "",
                "global_item_status": 1,
                "create_time": 1605247451,
                "update_time": 1605247451,
                "image": {
                    "image_id_list": [
                        "bf5a022e4624ff6c01ef151001762db7",
                        "1a689fb0124a6d8762761f3ae13815ed",
                        "7432bfa3713715bc1f88f4025241eb6d"
                    ],
                    "image_url_list": [
                        "https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7",
                        "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed",
                        "https://s-cf-tw.shopeesz.com/file/7432bfa3713715bc1f88f4025241eb6d"
                    ]
                },
                "weight": 1,
                "dimension": {
                    "package_length": 0,
                    "package_width": 0,
                    "package_height": 0
                },
                "pre_order": {
                    "days_to_ship": 2
                },
                "size_chart": "",
                "condition": "NEW",
                "has_model": true,
                "brand":{
                    "brand_id":123,
                    "original_brand_name":"nike"
                },
                "attribute_list": [
                    {
                        "attribute_id": 4811,
                        "original_attribute_name": "Brand: L2 Default [14644]",
                        "is_mandatory": false,
                        "attribute_value_list":[
                              {
                                  "value_id": 0,
                                  "original_value_name": "",
                                  "value_unit": ""
                              }
                        ]
                    }
                ],
"description_type":"extended",
"description_info":{
                    "extended_description":{
                        "field_list":[
                            {
                                "field_type":"text",
                                "text":"text description 1"
                            },
                            {
                                "field_type":"image",
                                "image_info":{
                                    "image_id":"1e076dff0699d8e778c06dd6c02df1fe",
                                    "image_url":"https://cf.shopee.sg/file/1e076dff0699d8e778c06dd6c02df1fe"
                                }
                            },
                            {
                                "field_type":"image",
                                "image_info":{
                                    "image_id":"c07ac95ba7bb624d731e37fe2f0349de",
                                    "image_url":"https://cf.shopee.sg/file/c07ac95ba7bb624d731e37fe2f0349de"
                                }
                            },
                            {
                                "field_type":"text",
                                "text":"text description 1"
                            }
                        ]
                    }
                }
            }
        ]
    }
}
#

§13 Error example

Error example

#

§14 JSON

JSON

{
    "error": "product.error_server",
    "message": "server internal error mtsku no found",
    "request_id": "ada4061f989f1e8baaba1bae4c68696f"
}
#

§15 Errors

Errors

ErrorDescriptionSolution
error_networkInner http call failed
error_dataparse data failed
error_datadata not exist
error_paramparameter invalid
error_paramThe information you queried is not found.
error_paramWrong parameters, detail: {msg}.
error_serverSomething wrong. Please try later.
error_paramrequest not from gateway
error_global_item_shop_not_matchGlobal item not belong to shop.
error_invalid_global_item_idInvalid global_item_id.
error_busi_global_item_model_price_no_matchGlobal_model_id and global_item_id not match.
error_innerOur system is taking some time to respond, please try later.
error_innerSystem error, please try again later or contact the OpenAPI support team.
error_innerUpdate item failed {{.error_info}}
error_innerUpdate item failed {{.error_info}}
error_innerSystem error, please try again later or contact the OpenAPI support team.
error_innerSystem error, please try again later or contact the OpenAPI support team.
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_authYour shop can not use model level dts
error_param{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_desc_image_no_pass{{.error_info}}
error_param{{.error_info}}
error_system_busyOur system is taking some time to respond, please try later.
#

§16 Common errors

Common errors

ErrorDescriptionSolution
error_authpartner_id is invalid
error_authThe App is deleted, and you'll be unable to make any API call.
error_authApp developer’s permissions for authorizations have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
error_paramThere is no partner_id in query.
error_paramInvalid partner_id.
error_paramno timestamp
error_paramInvalid timestamp
error_paramThere is no sign in query.
error_signWrong sign.
invalid_partner_idInvalid partner_id, please have a check.
error_authNo permission to current api.
error_api_call_restrictedThe App permission for api call have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
api_suspendedThe API is offline. Please call v2 API instead.
error_limitThe total API call number made by your APP has reached the daily API call limit, please try again after 00: 00 (UTC+08:00)
error_rate_limitToo many requests. You have reached the rate limit. Please try again later.
source_ip_undeclaredRequest Source IP ({ip}) is undeclared. Please declare all your IP addresses in the Shopee Open Platform Console > App list > IP Address Whitelist
error_paramPermission denied. This API is currently offline or the request path is incorrect.
error_paramPartner_id is invalid, should be an integer between 0 and 4294967295.
error_paramno timestamp.
error_paramTimestamp is invalid, should be an integer between 0 and 4294967295.
error_paramTimestamp is expired.
error_partner_key_expiredYour API partner key has expired, please reset the Live API Partner Key in Console to get a new valid partner key to call open api.
error_api_permissionThis app type has no permission to this API.
error_paramThere is no access_token in query.
error_authInvalid access_token.
merchant_no_linkedPartner and merchant has no linked.
invalid_acceess_tokenInvalid access_token, please have a check.
partner_frozenThe Partner has been frozen. Permissions for merchant authorization and API calls have been suspended until permissions are restored.
error_paramThere is no merchant_id in query.
error_parammerchant_id is invalid, should be an integer between 0 and 4294967295.
#

§17 Update log

Update log

DateChange
2025-02-18add size_chart_id
2025-02-17add is_fulfillment_by_shopee
2024-06-21update the description of DTS
2024-05-29update the description of weight and dimension
2022-03-09update global_status description
#