海外电商平台虾皮商品详情API接口技术指南
一、接口概述
虾皮商品详情API接口用于获取指定商品的详细信息,包括标题、价格、规格、描述、图片等核心数据。该接口采用RESTful风格,支持GET请求,返回JSON格式数据。
二、认证方式
调用接口需使用OAuth 2.0认证,需在请求头携带访问令牌:
Authorization: Bearer < access_token >
三、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| 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进行编码处理
提示:实际调用前请查阅最新版官方文档,接口可能有版本更新。建议使用官方提供的SDK简化开发流程。
审核编辑 黄宇
