淘宝开放平台API实战：商品详情接口item

本文链接：https://blog.csdn.net/m0_56020426/article/details/147456333

一、接口概述

淘宝开放平台提供了丰富的API接口，其中商品详情接口(item_get)是开发者最常用的接口之一。通过该接口，开发者可以获取淘宝商品的详细信息，包括标题、价格、销量、描述、图片等关键数据。

1.1 接口功能

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

- 获取商品详细描述

- 获取商品图片信息

- 获取商品SKU信息

- 获取商品促销信息

1.2 接口权限

需要申请淘宝开放平台的开发者权限，并获取相应的App Key和App Secret。

二、接口调用准备

2.1 申请开发者权限

- 访问淘宝开放平台(淘宝开放平台)

- 注册开发者账号

- 创建应用，获取App Key和App Secret

2.2 接口文档

官方文档地址：开放平台-文档中心

三、接口调用实战

3.1 请求参数说明

参数名	类型	是否必须	描述
method	String	是	API接口名称，固定值：taobao.item.get
num_iid	Number	是	商品ID
fields	String	是	需要返回的字段列表
api_key	String	是	应用的App Key
secret	String	是	应用的App Secret

3.2 Python调用示例代码


```python

import requests

import hashlib

import time

import urllib.parse

def get_taobao_item(item_id, api_key, secret):

# 基础参数

base_params = {

'method': 'taobao.item.get',

'app_key': api_key,

'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),

'format': 'json',

'v': '2.0',

'sign_method': 'md5',

'num_iid': item_id,

'fields': 'num_iid,title,price,pic_url,item_img,prop_img,sku,detail_url',

}

# 生成签名

def generate_sign(params, secret):

# 参数排序

sorted_params = sorted(params.items(), key=lambda x: x[0])

# 拼接字符串

query_string = secret + ''.join([f'{k}{v}' for k, v in sorted_params]) + secret

# MD5加密

return hashlib.md5(query_string.encode('utf-8')).hexdigest().upper()

# 添加签名

base_params['sign'] = generate_sign(base_params, secret)

# 发送请求

response = requests.get('https://eco.taobao.com/router/rest', params=base_params)

return response.json()

# 使用示例

if __name__ == '__main__':

api_key = '你的AppKey'

secret = '你的AppSecret'

item_id = '商品ID'

result = get_taobao_item(item_id, api_key, secret)

print(result)

```

3.3 Java调用示例代码


```java

import org.apache.commons.codec.digest.DigestUtils;

import org.apache.http.HttpResponse;

import org.apache.http.client.methods.HttpGet;

import org.apache.http.impl.client.CloseableHttpClient;

import org.apache.http.impl.client.HttpClients;

import org.apache.http.util.EntityUtils;

import java.io.IOException;

import java.net.URLEncoder;

import java.util.*;

public class TaobaoApiDemo {

public static String getTaobaoItem(String itemId, String apiKey, String secret) throws IOException {

// 基础参数

Map<String, String> params = new HashMap<>();

params.put("method", "taobao.item.get");

params.put("app_key", apiKey);

params.put("timestamp", new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));

params.put("format", "json");

params.put("v", "2.0");

params.put("sign_method", "md5");

params.put("num_iid", itemId);

params.put("fields", "num_iid,title,price,pic_url,item_img,prop_img,sku,detail_url");

// 生成签名

String sign = generateSign(params, secret);

params.put("sign", sign);

// 构建请求URL

String url = buildRequestUrl(params);

// 发送请求

CloseableHttpClient httpClient = HttpClients.createDefault();

HttpGet httpGet = new HttpGet(url);

HttpResponse response = httpClient.execute(httpGet);

return EntityUtils.toString(response.getEntity());

}

private static String generateSign(Map<String, String> params, String secret) {

// 参数排序

List<String> keys = new ArrayList<>(params.keySet());

Collections.sort(keys);

// 拼接字符串

StringBuilder query = new StringBuilder(secret);

for (String key : keys) {

query.append(key).append(params.get(key));

}

query.append(secret);

// MD5加密

return DigestUtils.md5Hex(query.toString()).toUpperCase();

}

private static String buildRequestUrl(Map<String, String> params) {

StringBuilder url = new StringBuilder("https://eco.taobao.com/router/rest?");

for (Map.Entry<String, String> entry : params.entrySet()) {

url.append(entry.getKey())

.append("=")

.append(URLEncoder.encode(entry.getValue()))

.append("&");

}

return url.substring(0, url.length() - 1);

}

public static void main(String[] args) throws IOException {

String apiKey = "你的AppKey";

String secret = "你的AppSecret";

String itemId = "商品ID";

String result = getTaobaoItem(itemId, apiKey, secret);

System.out.println(result);

}

}

```

四、返回结果解析

4.1 成功响应示例


```json

{

"item_get_response": {

"item": {

"num_iid": "123456789",

"title": "示例商品标题",

"price": "99.00",

"pic_url": "https://img.alicdn.com/example.jpg",

"item_imgs": {

"item_img": [

{

"id": "1",

"url": "https://img.alicdn.com/example1.jpg"

},

{

"id": "2",

"url": "https://img.alicdn.com/example2.jpg"

}

]

},

"detail_url": "https://item.taobao.com/item.htm?id=123456789",

"sku": {

"sku": [

{

"sku_id": "123",

"price": "99.00",

"properties": "颜色:红色;尺寸:XL"

}

]

}

}

}

}

```

4.2 常见错误码

错误码	描述	解决方案
11	无效的App Key	检查App Key是否正确
25	签名错误	检查签名生成逻辑
41	缺少必要参数	检查是否缺少num_iid等必要参数
200	商品不存在	检查商品ID是否正确