一、接口功能概述
义乌购商品详情API接口（yiwugo.item_get）提供商品核心数据的获取能力，开发者可通过商品唯一ID（num_iid）查询以下信息：
基础信息：商品标题、描述、主图URL 交易信息：实时价格、库存量、销量统计 商家信息：店铺名称、信用等级、联系方式 扩展数据：促销活动状态、优惠券信息（需指定is_promotion=1参数）
接口请求方式为GET，支持JSON格式响应，适用于商品详情页开发、价格监控等场景。
二、接口调用步骤
- 开发者账号注册与认证 访问义乌购开放平台，完成企业/个人开发者注册并创建应用 获取API密钥（key）和访问令牌（secret），用于身份验证
- 请求URL构造
基础URL格式：
text Copy Code api.yiwugo.com/v1/product/…
关键参数说明：
num_iid：商品唯一标识（必填）
cache：是否启用缓存（建议设为no获取实时数据）
lang：返回语言（如zh-CN简体中文）
三、Python代码示例
python
Copy Code
import requests
import json
def get_product_detail(num_iid):
url = "api.yiwugo.com/v1/product/…"
params = {
"key": "your_api_key",
"secret": "your_secret",
"num_iid": num_iid,
"cache": "no",
"lang": "zh-CN"
}
try:
response = requests.get(url, params=params)
response.raise_for_status() # 检查HTTP错误
data = response.json()
if data["code"] == 200:
return data["result"]
else:
print(f"API错误: {data['msg']}")
return None
except requests.exceptions.RequestException as e:
print(f"请求失败: {e}")
return None
调用示例
product_info = get_product_detail("931405691")
if product_info:
print(f"商品标题: {product_info['title']}")
print(f"当前价格: {product_info['price']}元")
注：需替换your_api_key和your_secret为实际凭证
四、响应数据处理
-
关键字段解析 json Copy Code {
"code": 200,
"result": {
"title": "创意LED台灯",
"price": 45.80,
"stock": 5000,
"sales": 1200,
"shop_name": "义乌光源科技",
"images": ["img.yiwugo.com/p1.jpg", ...]
}
} -
异常处理建议 HTTP状态码非200：检查网络连接或API服务状态 code字段非200：根据msg提示调整参数（如无效的num_iid） 频率超限：遵循API速率限制（通常≤100次/分钟） 五、最佳实践与注意事项 数据缓存优化：对静态数据（如商品描述）启用本地缓存，降低API调用频率 安全防护：避免在客户端暴露secret，建议通过服务端代理调用 字段更新策略：实时性要求高的字段（如库存、价格）建议每小时更新
