淘宝商品详情API开发指南：H5与APP端接口调用详解-CSDN博客

本文链接：https://blog.csdn.net/2501_91698259/article/details/147424301

一、前言

在电商应用开发中，获取商品详情是一个核心功能。淘宝作为国内最大的电商平台，其商品详情接口被广泛应用于各种电商解决方案中。本文将详细介绍如何调用淘宝的H5和APP端商品详情接口，并提供完整的代码实现。

二、淘宝详情接口概述

1. 接口类型

淘宝平台提供了多种商品详情接口，主要包括：

- H5端商品详情接口

- APP端商品详情接口

- PC端商品详情接口

2. 接口权限

调用淘宝API需要先申请开发者权限，获取App Key和App Secret。可以通过淘宝开放平台(open.taobao.com)申请。

三、H5端商品详情接口实现

1. 接口地址

https://h5api.m.taobao.com/h5/mtop.taobao.detail.getdetail/6.0/

2. 请求参数

参数名	类型	必填	说明
data	String	是	加密的请求数据

3. 示例代码


```python

import requests

import json

import hashlib

import time

def get_h5_item_detail(item_id):

# 基础参数

api_url = "https://h5api.m.taobao.com/h5/mtop.taobao.detail.getdetail/6.0/"

app_key = "你的AppKey"

t = str(int(time.time() * 1000))

# 构造请求数据

data = {

"itemNumId": str(item_id),

"exParams": json.dumps({"id": str(item_id)}),

"detail_v": "8.0.0"

}

# 签名参数

sign_str = f'{app_key}&{t}&{"12574478"}&{json.dumps(data)}'

sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()

# 请求头

headers = {

'User-Agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 11_0 like Mac OS X) AppleWebKit/604.1.38 (KHTML, like Gecko) Version/11.0 Mobile/15A372 Safari/604.1',

}

# 请求参数

params = {

'jsv': '2.5.1',

'appKey': app_key,

't': t,

'sign': sign,

'api': 'mtop.taobao.detail.getdetail',

'v': '6.0',

'type': 'jsonp',

'dataType': 'jsonp',

'data': json.dumps(data)

}

try:

response = requests.get(api_url, params=params, headers=headers)

result = response.json()

return result

except Exception as e:

print(f"请求失败: {e}")

return None

# 使用示例

item_id = "602100000000" # 示例商品ID

detail = get_h5_item_detail(item_id)

print(detail)

```

四、APP端商品详情接口实现

1. 接口地址

```

https://api.m.taobao.com/rest/api3.do?api=mtop.taobao.detail.getdetail

```

2. 请求参数

参数名	类型	必填	说明
method	String	是	接口方法名
appKey	String	是	应用Key
t	String	是	时间戳
sign	String	是	签名
v	String	是	版本号
data	String	是	请求数据

3. 示例代码


```python

def get_app_item_detail(item_id):

# 基础参数

api_url = "https://api.m.taobao.com/rest/api3.do"

app_key = "你的AppKey"

app_secret = "你的AppSecret"

t = str(int(time.time() * 1000))

# 构造请求数据

data = {

"itemNumId": str(item_id),

"detail_v": "8.0.0",

"umpChannel": "null",

"spm": "a2141.7631565",

"bc_fl_src": "cross_frm_tb_src"

}

# 生成签名

sign_str = f'{app_secret}appKey{app_key}data{json.dumps(data)}methodmtop.taobao.detail.getdetailt{t}v1.0{app_secret}'

sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

# 请求参数

params = {

'method': 'mtop.taobao.detail.getdetail',

'appKey': app_key,

't': t,

'sign': sign,

'v': '1.0',

'data': json.dumps(data)

}

try:

response = requests.get(api_url, params=params)

result = response.json()

return result

except Exception as e:

print(f"请求失败: {e}")

return None

# 使用示例

item_id = "602100000000" # 示例商品ID

detail = get_app_item_detail(item_id)

print(detail)

```

五、接口返回数据处理

1. 通用返回字段

两个接口返回的数据结构类似，主要包含以下信息：

- 商品基础信息（标题、价格、销量等）

- 商品图片

- 商品SKU信息

- 商品描述

- 店铺信息

- 促销信息

2. 数据处理示例

```python

def parse_item_detail(detail_data):

if not detail_data or 'data' not in detail_data:

return None

item_data = detail_data['data'].get('item', {})

result = {

'title': item_data.get('title'),

'price': item_data.get('price'),

'original_price': item_data.get('originalPrice'),

'sales': item_data.get('soldQuantity'),

'images': [img.get('url') for img in item_data.get('images', [])],

'props': item_data.get('props'),

'sku': item_data.get('sku'),

'desc_url': item_data.get('descUrl'),

'shop_info': {

'name': item_data.get('shop', {}).get('name'),

'shopId': item_data.get('shop', {}).get('shopId')

}

}

return result

# 使用示例

parsed_data = parse_item_detail(detail)

print(json.dumps(parsed_data, indent=2, ensure_ascii=False))

```