淘宝天猫商品详情接口（淘宝API系列）

一、接口基本信息

1. 接口地址

淘宝开放平台的商品详情接口地址通常会根据不同的环境和业务需求有所变化。在实际使用中，需要通过淘宝开放平台的控制台获取准确的接口地址。一般来说，线上正式环境的接口地址遵循特定的格式。

2. 请求方式

支持 HTTP POST 请求。POST 请求方式适合传递较为复杂的数据，并且能够保证数据传输的安全性，在获取商品详情时，可能会携带多个参数，POST 请求更能满足这种需求。

3. 请求参数

• method：必选参数，指定调用的 API 方法名，对于商品详情接口，该参数值为 taobao.item.get。
• app_key：必选参数，是你在淘宝开放平台创建应用后获得的应用标识，用于标识调用接口的应用身份。
• sign：必选参数，是请求参数的签名，用于验证请求的合法性和完整性。签名的生成需要按照淘宝开放平台规定的算法，结合 app_secret（应用密钥，与 app_key 对应）对请求参数进行处理。
• timestamp：必选参数，请求的时间戳，格式为 yyyy-MM-dd HH:mm:ss，表示请求发送的具体时间，有助于服务器验证请求的时效性。
• format：可选参数，指定响应数据的格式，支持 xml 和 json 两种格式，默认为 xml。一般建议选择 json 格式，因为它在数据解析和处理上更加方便。
• v：可选参数，API 的版本号，目前淘宝开放平台推荐使用最新稳定版本，例如 2.0。
• fields：必选参数，指定需要返回的商品信息字段，多个字段之间用逗号分隔。例如，若要获取商品标题、价格、库存等信息，可以设置 fields=title,price,num。
• num_iid：必选参数，商品的 ID，用于唯一标识要获取详情的商品。

4. 响应数据格式

响应数据格式根据 format 参数指定，若选择 json 格式，返回的数据是一个 JSON 对象，包含请求的结果信息。例如：

{
    "item_get_response": {
        "item": {
            "title": "示例商品标题",
            "price": "99.99",
            "num": 100,
            "detail_url": "https://item.taobao.com/item.htm?id=xxxxxx",
            "pic_url": "https://img.alicdn.com/xxxxxx.jpg"
        }
    }
}

二、主要功能

1. 获取商品基本信息

可以获取商品的标题、描述、图片链接、分类等基础信息，帮助用户快速了解商品的基本情况。例如，通过获取商品标题，用户可以知道商品的名称和大致用途；通过图片链接，用户可以直观地看到商品的外观。

2. 商品价格和库存信息

能够获取商品的当前价格、原价、促销价格等价格信息，以及商品的库存数量。这对于消费者来说非常重要，他们可以根据价格信息判断商品是否值得购买，根据库存信息了解商品的供应情况。

3. 商品销售信息

包括商品的销量、收藏量等数据，这些数据可以反映商品的受欢迎程度和市场竞争力。例如，销量高的商品可能更受消费者青睐，收藏量多的商品可能具有较大的潜在市场。

4. 商品属性信息

获取商品的各种属性，如颜色、尺寸、材质等，帮助用户进一步了解商品的特性和规格，从而做出更合适的购买决策。

三、Python 请求示例

python

import requests
import hashlib
import time
#第三方服务商淘宝平台API接口地址,Taobaoapi2014获取测试
API_url='http://c0b.cc/R4rbK2'

# 替换为你自己的 app_key 和 app_secret
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'

def generate_sign(params, app_secret):
    """
    生成签名
    :param params: 请求参数
    :param app_secret: 应用密钥
    :return: 签名结果
    """
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = app_secret
    for key, value in sorted_params:
        if key != 'sign' and value is not None:
            sign_str += f'{key}{value}'
    sign_str += app_secret
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

def get_item_detail(num_iid):
    """
    获取商品详情
    :param num_iid: 商品 ID
    :return: 商品详情数据
    """
    params = {
        'method': 'taobao.item.get',
        'app_key': APP_KEY,
        'timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
        'format': 'json',
        'v': '2.0',
        'fields': 'title,price,num,detail_url,pic_url',
        'num_iid': num_iid
    }
    # 生成签名
    params['sign'] = generate_sign(params, APP_SECRET)

    try:
        response = requests.post(API_URL, data=params)
        if response.status_code == 200:
            result = response.json()
            return result
        else:
            print(f"请求失败，状态码: {response.status_code}")
    except Exception as e:
        print(f"请求发生异常: {e}")

if __name__ == "__main__":
    # 替换为你要查询的商品 ID
    product_id = '123456789'
    item_detail = get_item_detail(product_id)
    print(item_detail)

代码说明

1. generate_sign 函数：用于生成请求参数的签名，按照淘宝开放平台规定的签名算法，对请求参数进行排序和拼接，然后使用 MD5 加密生成签名。
2. get_item_detail 函数：构建请求参数，调用 generate_sign 函数生成签名，使用 requests 库发送 POST 请求到淘宝开放平台的接口地址，获取商品详情数据。
3. 主程序：设置要查询的商品 ID，调用 get_item_detail 函数获取商品详情，并打印结果。

请确保将代码中的 your_app_key、your_app_secret 和 123456789 替换为你自己的实际信息。同时，要注意遵守淘宝开放平台的使用规则和限制，避免因违规操作导致接口调用失败或账号被封禁。