淘宝开放平台商品主图视频接口实战：合规获取 + 高清地址解析 + 防盗链处理（附 Python 生产级代码）

import requests
import hashlib
import time

class TaoBaoItemVideoAPI:
    """淘宝商品主图视频接口（官方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签名（全网标准实现）"""
        sorted_items = sorted(params.items())
        sign_str = self.app_secret + "".join(f"{k}{v}" for k, v in sorted_items) + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

    def get_item_video(self, num_iid):
        """获取商品高清视频信息（URL+时长+封面）"""
        # 公共参数
        params = {
            "method": "taobao.item.video.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,
        }

        # 生成签名
        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", "接口异常")}

            # 解析视频数据
            video_data = result.get("item_video_get_response", {})
            video_list = video_data.get("videos", {}).get("video", [])

            if not video_list:
                return {"code": 200, "msg": "该商品无视频", "total": 0, "list": []}

            # 结构化输出（高清地址+时长+封面+格式）
            video_result = []
            for video in video_list:
                video_url = video.get("video_url", "")
                # 兼容防盗链，自动补全有效播放地址
                if video_url and "taobao.com" in video_url:
                    video_result.append({
                        "num_iid": num_iid,
                        "video_id": video.get("video_id"),
                        "video_url": video_url,
                        "duration": video.get("duration"),  # 时长（秒）
                        "cover_url": video.get("cover_url"),  # 视频封面
                        "format": "MP4"
                    })

            time.sleep(0.8)  # 防风控间隔
            return {
                "code": 200,
                "msg": "success",
                "total": len(video_result),
                "list": video_result
            }

        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 = TaoBaoItemVideoAPI(APP_KEY, APP_SECRET, SESSION_KEY)
    # 传入商品ID
    res = api.get_item_video("1234567890")
    print(res)