1. 准备工作

1.1 注册开发者账号

• 访问淘宝开放平台
• 注册成为开发者并完成实名认证

1.2 创建应用

1. 登录开放平台控制台
2. 进入"应用管理" → "创建应用"
3. 填写应用信息，选择"API应用"类型
4. 记录下生成的 App Key和 App Secret

1.3 申请API权限

• 在"API管理"中搜索 taobao.item.get接口
• 申请调用权限（部分接口需要审核）

2. API调用方式

2.1 请求参数

taobao.item.get接口主要参数：

• num_iid: 商品数字ID（必填）
• fields: 需要返回的字段列表（可选，默认返回所有字段）

2.2 调用示例

使用SDK调用（推荐）

java// 淘宝Java SDK示例import com.taobao.api.DefaultTaobaoClient;import com.taobao.api.TaobaoClient;import com.taobao.api.request.ItemGetRequest;import com.taobao.api.response.ItemGetResponse;public class TaobaoItemGetExample {public static void main(String[] args) {String url = "https://eco.taobao.com/router/rest";String appKey = "your_app_key";String appSecret = "your_app_secret";TaobaoClient client = new DefaultTaobaoClient(url, appKey, appSecret);ItemGetRequest req = new ItemGetRequest();req.setNumIid(123456789L); // 商品IDreq.setFields("num_iid,title,price,pic_url,detail_url"); // 指定返回字段try {ItemGetResponse response = client.execute(req);System.out.println(response.getBody());} catch (Exception e) {e.printStackTrace();}}}

直接HTTP调用

POST https://eco.taobao.com/router/rest参数：method=taobao.item.getapp_key=your_app_keytimestamp=2023-01-01+12:00:00v=2.0sign_method=md5num_iid=123456789fields=num_iid,title,price,pic_urlsign=生成的签名

2.3 签名生成

淘宝API要求所有请求必须签名，签名算法步骤：

1. 将所有参数（除sign外）按字母顺序排序
2. 拼接成key=value形式，用&连接
3. 在首尾加上appSecret
4. 对字符串进行MD5加密，得到签名

3. 返回数据解析

成功响应示例（JSON格式）：

json{"item_get_response": {"item": {"num_iid": 123456789,"title": "商品标题","price": "99.90","pic_url": "http://img.alicdn.com/bao/uploaded/image.jpg","detail_url": "https://item.taobao.com/item.htm?id=123456789","item_imgs": [{"url": "http://img.alicdn.com/bao/uploaded/image1.jpg"}],"props_name": "颜色:红色,尺寸:M","sku": {"skus": [{"sku_id": 1111111,"quantity": 100,"price": "99.90","properties": "颜色:红色,尺寸:M"}]}}}}

4. 注意事项

1. 调用频率限制：默认每个App Key的QPS限制为10，超出会被限流
2. 字段选择：建议只请求需要的字段，减少数据传输量
3. 错误处理：检查返回中的error_response节点处理错误情况
4. 沙箱环境：开发初期可使用沙箱环境测试
5. 授权机制：如需获取其他店铺商品信息，需要用户授权

5. 常见问题

5.1 如何获取商品ID？

• 从商品详情页URL中获取，如： https://item.taobao.com/item.htm?id=123456789中的123456789
• 通过搜索API获取商品列表后再调用本接口

5.2 返回"isv.invalid-permission"错误

• 检查是否申请了该API的调用权限
• 确认App Key和App Secret正确
• 检查签名是否正确

5.3 如何获取商品详情描述？

taobao.item.get不返回商品详情描述内容，如需获取需要使用：

• taobao.item.desc.get接口获取HTML格式描述
• 或使用 taobao.item.detail.get获取结构化详情

通过以上步骤，您就可以成功使用淘宝开放平台的API获取商品详细信息了。