淘宝开放平台商品详情接口实战：官方 TOP API 签名 + 结构化解析（附 Python 生产级代码）

import requests
import hashlib
import time

class TaoBaoItemAPI:
    """淘宝商品详情接口（官方TOP API 生产级封装）"""
    def __init__(self, app_key, app_secret, session_key):
        self.app_key = app_key
        self.app_secret = app_secret
        self.session_key = session_key
        self.api_url = "https://eco.taobao.com/router/rest"

    def _create_sign(self, params):
        """淘宝标准MD5签名（全网最标准实现）"""
        # 按key字典升序排序
        sorted_items = sorted(params.items())
        # 拼接：secret + k1v1k2v2 + secret
        wait_sign = self.app_secret + "".join([f"{k}{v}" for k, v in sorted_items]) + self.app_secret
        # MD5 大写
        return hashlib.md5(wait_sign.encode("utf-8")).hexdigest().upper()

    def get_item_detail(self, num_iid):
        """获取商品详情"""
        # 公共参数
        params = {
            "method": "taobao.item.get",
            "app_key": self.app_key,
            "session": self.session_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "format": "json",
            "v": "2.0",
            "sign_method": "md5",
            "num_iid": num_iid,
            "fields": "num_iid,title,price,pic_url,num,detail_url"
        }

        # 生成签名
        params["sign"] = self._create_sign(params)

        try:
            # 发送请求
            resp = requests.post(self.api_url, data=params, timeout=10)
            result = resp.json()

            # 错误判断
            if "error_response" in result:
                err = result["error_response"]
                return {"code": -1, "msg": err.get("sub_msg", "接口异常")}

            # 解析数据
            item = result.get("item_get_response", {}).get("item", {})
            if not item:
                return {"code": -1, "msg": "未获取到商品信息"}

            # 结构化输出
            return {
                "code": 200,
                "msg": "success",
                "num_iid": item.get("num_iid"),
                "title": item.get("title"),
                "price": item.get("price"),
                "stock": item.get("num"),
                "pic_url": item.get("pic_url"),
                "detail_url": item.get("detail_url")
            }

        except Exception as e:
            return {"code": 500, "msg": f"请求异常：{str(e)}"}

# ———— 调用示例 ————
if __name__ == "__main__":
    # 替换为开放平台密钥
    APP_KEY = "你的app_key"
    APP_SECRET = "你的app_secret"
    SESSION_KEY = "你的session_key"

    api = TaoBaoItemAPI(APP_KEY, APP_SECRET, SESSION_KEY)
    # 传入商品真实ID
    res = api.get_item_detail("1234567890")
    print(res)