item_video：获得淘宝商品视频 API 接口实战演示说明

一、接口概述

淘宝商品视频 API（item_video）是淘宝开放平台提供的接口，用于获取商品详情页中的主图视频或其他关联视频。该接口支持通过商品 ID（num_iid）直接请求视频资源，返回包含视频 URL、封面图、时长等信息的结构化数据。

二、前期准备

1. 注册淘宝开放平台账号：访问淘宝开放平台官网，注册开发者账号并完成实名认证。

2. 创建应用：登录后进入「开发者中心」，创建一个应用，选择应用类型（如“网站应用”“移动应用”）。应用创建后，会获得唯一的 App Key 和 App Secret。

3. 申请接口权限：在应用的「接口管理」中，找到 item_video 接口，申请调用权限。

三、接口调用实战

（一）请求代码示例

以下是一个使用 Python 调用 item_video API 的完整示例代码：

import requests
import hashlib
import time

# 配置参数
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
num_iid = "906637149849"  # 替换为实际的商品 ID

# 请求地址
url = "https://api-gw.onebound.cn/taobao/item_video/"

# 请求参数
params = {
    "key": app_key,
    "secret": app_secret,
    "num_iid": num_iid,
    "cache": "no",  # 不使用缓存数据
    "result_type": "json",  # 返回数据格式为 JSON
    "lang": "cn",  # 返回数据语言为简体中文
}

# 发送 GET 请求
response = requests.get(url, params=params)
data = response.json()
print(data)

（二）响应数据解析

成功响应示例（JSON）：

{
  "item": {
    "num_iid": "906637149849",
    "title": "商品标题",
    "detail_url": "商品链接",
    "pic_url": "商品图片链接",
    "price": "商品价格",
    "orginal_price": "商品原价",
    "num": "商品库存",
    "brand": "商品品牌",
    "cid": "商品类目 ID",
    "props": [
      {
        "name": "属性名称",
        "value": "属性值"
      }
    ],
    "item_imgs": [
      {
        "url": "商品图片链接"
      }
    ],
    "video": "商品视频链接",
    "seller_id": "卖家 ID"
  }
}

四、常见问题及解决方法

（一）签名错误

问题：签名错误，通常是 sign 参数不正确。

解决方法：

• 检查 App Secret 是否正确。

• 确保参数排序正确，按照字母顺序排列。

• 确保签名算法正确，使用 MD5 算法。

（二）权限不足

问题：权限不足，通常是 code 返回 403。

解决方法：

• 检查是否已申请 item_video 接口的调用权限。

• 确保应用的权限未被限制。

（三）参数错误

问题：请求参数错误，通常是 code 返回 400。

解决方法：

• 检查请求参数是否符合 API 的要求。

• 确保所有必填参数都已正确传递。

五、总结

通过本文的介绍，你应该已经掌握了如何使用 1688 开放平台的 item_video API 接口来获取淘宝商品视频。在实际开发中，注意错误处理和日志记录，可以提高开发效率和代码的稳定性。如果遇到问题，可以参考 1688 开放平台的官方文档或在开发者社区寻求帮助。

如遇任何疑问或有进一步的需求，请随时与我私信或者评论联系。