义乌购商品详情接口调用指南：Python实战代码与完整示例

一、接口功能概述

义乌购商品详情API接口（yiwugo.item_get）提供商品核心数据的获取能力，开发者可通过商品唯一ID（num_iid）查询以下信息：

基础信息‌：商品标题、描述、主图URL‌
交易信息‌：实时价格、库存量、销量统计‌
商家信息‌：店铺名称、信用等级、联系方式‌
扩展数据‌：促销活动状态、优惠券信息（需指定is_promotion=1参数）‌

接口请求方式为‌GET‌，支持JSON格式响应，适用于商品详情页开发、价格监控等场景‌。

点击获取key和secret

二、接口调用步骤
1. 开发者账号注册与认证
访问义乌购开放平台，完成企业/个人开发者注册并创建应用‌
获取API密钥（key）和访问令牌（secret），用于身份验证‌
2. 请求URL构造

基础URL格式：

text
Copy Code
https://api.yiwugo.com/v1/product/detail?key=your_api_key&secret=your_secret&num_iid=商品ID  

关键参数说明‌：

num_iid：商品唯一标识（必填）‌
cache：是否启用缓存（建议设为no获取实时数据）‌
lang：返回语言（如zh-CN简体中文）‌
三、Python代码示例
python
Copy Code
import requests  
import json  

def get_product_detail(num_iid):  
    url = "https://api.yiwugo.com/v1/product/detail"  
    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为实际凭证‌

四、响应数据处理
1. 关键字段解析
json
Copy Code
{  
  "code": 200,  
  "result": {  
    "title": "创意LED台灯",  
    "price": 45.80,  
    "stock": 5000,  
    "sales": 1200,  
    "shop_name": "义乌光源科技",  
    "images": ["https://img.yiwugo.com/p1.jpg", ...]  
  }  
}  

2. 异常处理建议
HTTP状态码非200‌：检查网络连接或API服务状态‌
code字段非200‌：根据msg提示调整参数（如无效的num_iid）‌
频率超限‌：遵循API速率限制（通常≤100次/分钟）‌
五、最佳实践与注意事项
数据缓存优化‌：对静态数据（如商品描述）启用本地缓存，降低API调用频率‌
安全防护‌：避免在客户端暴露secret，建议通过服务端代理调用‌
字段更新策略‌：实时性要求高的字段（如库存、价格）建议每小时更新‌