一、接口概述
虾皮商品详情API接口用于获取指定商品的详细信息，包括标题、价格、规格、描述、图片等核心数据。该接口采用RESTful风格，支持GET请求，返回JSON格式数据。
二、认证方式
调用接口需使用OAuth 2.0认证，需在请求头携带访问令牌：
Authorization: Bearer
三、请求参数
参数名 类型 是否必填 说明
item_id string 是 商品唯一标识
language string 否 返回语言（默认en）
version int 否 API版本（默认1）
四、请求示例
import requests
url = "https://api.shopee.com/v2/items/get_detail"
params = {
"item_id": "1234567890",
"language": "zh"
}
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
response = requests.get(url, params=params, headers=headers)
data = response.json()
五、响应结构
{
"code": 0,
"data": {
"item_id": "1234567890",
"title": "无线蓝牙耳机",
"price": 29.99,
"currency": "USD",
"specs": [
{"key": "颜色", "value": "黑色"},
{"key": "续航", "value": "20小时"}
],
"images": [
"https://img.shopee.com/xxx1.jpg",
"https://img.shopee.com/xxx2.jpg"
],
"description": "高保真音质...",
"stock": 150,
"rating": 4.8
},
"message": "success"
}
六、错误代码
代码 说明
0 请求成功
101 认证失败
201 商品不存在
301 参数错误
500 服务器内部错误
七、注意事项
每日调用限制：1000次/账号
数据缓存建议：商品数据更新周期为15分钟
多语言支持：通过language参数切换（支持zh/en/th/vi等）
特殊字符处理：需对URL进行编码处理
