电商平台虾皮shopeeAPI接口接入根据ID取商品详情代码演示说明

要接入虾皮（Shopee）电商平台的API接口并根据商品ID获取商品详情，你需要遵循以下步骤：

公共参数

请求地址: 获取请求接入key和secret

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=264070136/5637247041&country=.com.my

参数说明：num_iid:商品ID-country:网站后缀（.com.my;.vn;.ph）

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	5637247041	宝贝ID
title	String	0	Fashionable plus size womens dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit	宝贝标题
price	Float	0	22.17	价格
orginal_price	String	0	31.68	原价
num	Int	0	3836	库存
detail_url	String	0	https://shopee.com.my/product/264070136/5637247041	宝贝链接
pic_url	String	0	https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a	宝贝图片
brand	String	0	No Brand	品牌名称
favcount	Int	0	2027
desc	String	0
skus	Mix	0	{"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "0:0", "properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】", "quantity": "305", "sku_id": "3166598625985"}]	商品规格信息列表
has_discount	String	0	true
item_size	String	0
cid	Int	0	16
currency	String	0	MYR
size_chart	String	0	https://cf.shopee.com.my/file/6105b7c64414c2012908bff679b9321d
sales	Int	0	138	销量
item_imgs	Mix	0	[{ "url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"}	商品图片
discount	String	0	30%
location	String	0	Mainland China	发货地
shop_id	Int	0	151372205	店铺ID
seller_info	Mix	0	{"nick": "qzq1274334183.my", "city": "Mainland China", "level": 12, "seller_promotion_refresh_time": "2021-01-19 02:00:00", "zhuy": "https://shopee.com.my/shop/264070136/search", "shop_type": "A"}	卖家信息
prop_imgs	Mix	0	[]	属性图片
props_list	Mix	0	{20509:9974422: 尺码:36}	商品属性
props_name	String	0	0:0:T-shirt+skirt:M 建议【42.5-50KG】;0:1:T-shirt+skirt:L 建议 【50-57.5kg】;	商品属性名
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品详情
current_lang	String	0	en
currency_code	String	0	MYR
props_img	Mix	0	1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg	属性图片
shop_item	Mix	0	[]
relate_items	Mix	0	[]
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0	price_json error;skus miss;	警告信息
url_log	Mix	0	[]
method	String	0	item_tmall:pget_item
promo_type	String	0

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python
• Golang
• javascript
• JS-SDK
• Ruby
• Swift
• Objective-C
• C
• C++
• Node.JS
• Kotlin
• Rust
• R
• MATLAB

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my"

响应示例

异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}

 

 

1. 注册与认证：
   • 首先，你需要在Shopee开放平台注册一个账号，并创建一个应用。
   • 在创建应用的过程中，你需要填写相关信息，如应用名称、应用描述、回调URL等。
   • 完成应用创建后，Shopee会为你生成一个API密钥（API Key）和API密钥秘密（API Secret），这两个密钥将用于后续的API调用身份验证。
2. 阅读API文档：
   • 访问Shopee开放平台的API文档，找到与商品详情相关的API接口。
   • 仔细阅读API文档，了解接口的基本信息、请求参数、响应格式以及错误处理等。
3. 编写代码调用API：
   • 根据API文档，使用你熟悉的编程语言（如Python、Java、PHP等）编写代码。
   • 在代码中，你需要设置请求头，包括你的API密钥和API密钥秘密。
   • 构造请求URL，并传入商品ID作为参数。
   • 发送HTTP请求到Shopee的API服务器，并获取响应。