淘宝商品详情API技术实战解析：接口调用、数据处理与落地优化

import hashlib
import time
import requests

class TaobaoItemApi:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.api_url = "https://eco.taobao.com/router/rest"
    
    # 生成接口签名
    def generate_sign(self, params):
        sorted_params = sorted(params.items())
        sign_str = self.app_secret + "".join(f"{k}{v}" for k, v in sorted_params) + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
    
    # 单商品详情获取
    def get_single_item(self, num_iid, fields=None):
        fields = fields or "num_iid,title,price,num,sales,pic_url"
        params = {
            "method": "taobao.item_get_full",
            "app_key": self.app_key,
            "format": "json",
            "v": "2.0",
            "sign_method": "md5",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "num_iid": num_iid,
            "fields": fields
        }
        params["sign"] = self.generate_sign(params)
        try:
            response = requests.post(self.api_url, params=params, timeout=8)
            return response.json()
        except Exception as e:
            print(f"单商品接口调用异常：{str(e)}")
            return None
    
    # 多商品批量获取
    def get_batch_items(self, num_iids, fields=None):
        if len(num_iids) > 20:
            raise ValueError("批量查询最多支持20个商品ID")
        fields = fields or "num_iid,title,price,num,sales"
        params = {
            "method": "taobao.items.list.get",
            "app_key": self.app_key,
            "format": "json",
            "v": "2.0",
            "sign_method": "md5",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "num_iids": ",".join(num_iids),
            "fields": fields
        }
        params["sign"] = self.generate_sign(params)
        try:
            response = requests.post(self.api_url, params=params, timeout=10)
            return response.json()
        except Exception as e:
            print(f"批量商品接口调用异常：{str(e)}")
            return None

def validate_item_data(item_data):
    """
    淘宝商品详情API返回数据准确性校验
    :param item_data: 解析后的商品数据字典
    :return: (bool, dict) 校验结果、处理后的数据
    """
    if not item_data:
        return False, {}
    
    # 核心字段校验
    required_fields = ["num_iid", "title", "price", "num"]
    for field in required_fields:
        if field not in item_data or not item_data[field]:
            print(f"核心字段缺失：{field}")
            return False, {}
    
    # 数据格式与合法性校验
    try:
        # 商品ID校验（数字）
        if not str(item_data["num_iid"]).isdigit():
            return False, {}
        # 价格校验（正数）
        price = float(item_data["price"])
        if price <= 0:
            print(f"价格异常：{price}")
            return False, {}
        # 库存校验（非负）
        stock = int(item_data["num"])
        if stock < 0:
            print(f"库存异常：{stock}")
            return False, {}
        # 标题校验（长度≥5）
        if len(item_data["title"]) < 5:
            print(f"标题异常：{item_data['title']}")
            return False, {}
    except Exception as e:
        print(f"数据格式校验异常：{str(e)}")
        return False, {}
    
    # 处理后的数据（过滤冗余字段）
    processed_data = {
        "num_iid": item_data["num_iid"],
        "title": item_data["title"],
        "price": price,
        "stock": stock,
        "sales": int(item_data.get("sales", 0)),
        "pic_url": item_data.get("pic_url", ""),
        "cid": item_data.get("cid", ""),
        "modified_time": item_data.get("modified_time", "")
    }
    return True, processed_data

{
  "item_get_response": {
    "item": {
      "num_iid": "680123456789",  // 商品唯一标识，技术上用于数据关联、缓存key生成
      "title": "2025夏季新款纯棉宽松短袖T恤",  // 商品标题，需校验长度与合法性
      "price": "59.00",  // 商品标价，需转为float类型，校验正数
      "promotion_price": "49.90",  // 促销价，核心业务字段，需与标价联动校验
      "num": 320,  // 库存数量，int类型，校验非负
      "sales": 12860,  // 累计销量，int类型，用于数据统计
      "pic_url": "https://img.taobao.com/xxx.jpg",  // 主图链接，需校验URL有效性
      "cid": 50015261,  // 类目ID，用于商品分类关联
      "category_name": "女装 > T恤",  // 类目名称，辅助类目ID解析
      "props": "颜色:白色;尺码:M|L|XL",  // 商品规格，需解析为结构化规格数据
      "sku": [{"sku_id": "12345678901", "price": "49.90", "num": 80}],  // SKU数据，多规格场景核心字段
      "modified_time": "2026-04-28 14:15:22",  // 数据最后更新时间，用于增量同步、缓存失效
      "nick": "XX官方旗舰店",  // 店铺名称，辅助数据关联
      "location": "广东 广州"  // 发货地，辅助业务逻辑实现
    },
    "code": 200,  // 响应状态码，200为成功，非200需处理异常
    "msg": "success"  // 响应信息，辅助异常排查
  }
}