淘宝商品详情API实战：数据返回解析与落地应用

{
  "item_get_response": {
    "item": {
      "num_iid": "680123456789",
      "title": "2025夏季新款纯棉宽松短袖T恤 男女同款休闲百搭上衣",
      "price": "59.00",
      "promotion_price": "49.90",
      "num": 320,
      "sales": 12860,
      "pic_url": "https://img.taobao.com/imgextra/i1/123456/xxx.jpg",
      "detail_url": "https://detail.tmall.com/item.htm?id=680123456789",
      "nick": "XX官方旗舰店",
      "seller_id": "123456789",
      "location": "广东 广州",
      "cid": 50015261,
      "category_name": "女装 > T恤",
      "props": "颜色:白色;尺码:M|L|XL|XXL",
      "props_name": "颜色:白色;尺码:M(适合80-100斤)|L(适合100-120斤)|XL(适合120-140斤)|XXL(适合140-160斤)",
      "sku": [
        {
          "sku_id": "12345678901",
          "price": "49.90",
          "num": 80,
          "props": "颜色:白色;尺码:M"
        },
        {
          "sku_id": "12345678902",
          "price": "49.90",
          "num": 75,
          "props": "颜色:白色;尺码:L"
        }
      ],
      "desc": "<p>【商品亮点】</p><p>1. 面料：100%纯棉，透气吸汗，亲肤舒适</p><p>2. 版型：宽松显瘦，男女同款，百搭不挑人</p><p>3. 工艺：精细锁边，不易变形，耐洗耐穿</p>",
      "desc_images": [
        "https://img.taobao.com/imgextra/i2/123456/xxx1.jpg",
        "https://img.taobao.com/imgextra/i3/123456/xxx2.jpg"
      ],
      "brand": "XX品牌",
      "good_rate": "96.8%",
      "comment_count": 8650,
      "created_time": "2025-03-15 10:30:00",
      "updated_time": "2026-04-28 14:15:22"
    },
    "code": 200,
    "msg": "success"
  }
}

import requests
import hashlib
import time

# 1. 配置核心参数（替换为你的真实信息）
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
NUM_IID = "680123456789"  # 商品ID
API_URL = "https://eco.taobao.com/router/rest"

# 2. 生成淘宝API签名（核心步骤，避免调用失败）
def create_taobao_sign(params, secret):
    # 按参数名ASCII码升序排序
    sorted_params = sorted(params.items())
    # 拼接参数字符串
    sign_str = secret
    for k, v in sorted_params:
        sign_str += f"{k}{v}"
    sign_str += secret
    # MD5加密并转为大写
    return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

# 3. 调用淘宝商品详情API
def get_taobao_item_detail():
    # 公共参数 + 业务参数
    params = {
        "method": "taobao.item_get_full",
        "app_key": APP_KEY,
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "num_iid": NUM_IID
    }
    # 生成签名
    params["sign"] = create_taobao_sign(params, APP_SECRET)
    # 发送请求
    try:
        response = requests.get(API_URL, params=params, timeout=10)
        return response.json()
    except Exception as e:
        return {"error": f"API调用失败：{str(e)}"}

# 4. 数据准确性校验（核心实战函数）
def check_taobao_item_accuracy(json_data):
    try:
        # 校验根结构
        if "item_get_response" not in json_data:
            return False, "返回结构异常，无核心响应节点"
        item = json_data["item_get_response"].get("item", {})
        if not item:
            return False, "未获取到商品详情数据"
        
        # 核心字段校验
        # 商品ID校验
        if not item.get("num_iid") or not str(item["num_iid"]).isdigit():
            return False, f"商品ID无效：{item.get('num_iid')}"
        # 标题校验
        if not item.get("title") or len(item["title"]) < 5:
            return False, "商品标题无效或过短"
        # 价格校验（必须大于0）
        try:
            price = float(item.get("price", 0))
            if price <= 0:
                return False, f"商品价格异常：{price}"
        except:
            return False, f"价格格式错误：{item.get('price')}"
        # 库存校验（不能为负）
        try:
            stock = int(item.get("num", 0))
            if stock< 0:
                return False, f"库存异常：{stock}"
        except:
            pass
        # 主图校验
        if not item.get("pic_url") or "http" not in item["pic_url"]:
            return False, "商品主图无效"
        # 类目校验
        if not item.get("cid"):
            return False, "商品类目缺失"
        
        return True, "数据校验通过，可正常使用"
    except Exception as e:
        return False, f"校验异常：{str(e)}"

# 5. 实战执行：调用API + 校验数据
if __name__ == "__main__":
    # 调用API获取数据
    item_data = get_taobao_item_detail()
    # 校验数据准确性
    is_ok, msg = check_taobao_item_accuracy(item_data)
    print(f"校验结果：{is_ok}，提示：{msg}")
    # 校验通过后，提取核心数据用于业务开发
    if is_ok:
        item = item_data["item_get_response"]["item"]
        print(f"\n提取核心数据：")
        print(f"商品ID：{item['num_iid']}")
        print(f"商品标题：{item['title']}")
        print(f"售价：{item['price']}元，促销价：{item['promotion_price']}元")
        print(f"库存：{item['num']}件，累计销量：{item['sales']}件")
        print(f"店铺名称：{item['nick']}，发货地：{item['location']}")