淘宝作为中国最大的电子商务平台之一,拥有海量的商品信息和数据。对于开发者而言,能够获取并解析淘宝商品详情API接口返回的数据,可以极大地丰富应用的功能和用户体验。本指南将详细介绍如何使用淘宝商品详情API接口获取商品属性,并对返回的数据进行解析。
一、API接口概述
淘宝商品详情API接口是淘宝开放平台提供的一个服务接口,通过该接口,开发者可以获取指定商品的详细信息,包括商品标题、价格、属性、图片等。接口采用HTTP协议进行通信,返回的数据格式为JSON。
二、调用API接口
1.准备参数
在调用API接口之前,需要准备相应的参数。主要包括商品ID(item_id)、API密钥(app_key)和API签名(sign)等。其中,商品ID用于指定要获取详情的商品;API密钥和API签名用于验证开发者身份和请求的有效性。
2.构造请求URL
根据API接口的要求,将参数按照规定的格式拼接成请求URL。具体的拼接方式可以参考淘宝开放平台的官方文档。
3.发送请求
使用HTTP协议发送请求到构造好的URL地址。请求方式通常为GET或POST,具体取决于API接口的要求。
4.接收响应
等待服务器响应,并接收返回的数据。返回的数据格式为JSON,包含了商品的详细信息。
taobao.item_get
公共参数
请求地址: https://api-gw.onebound.cn/taobao/item_get
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=652874751412&is_promotion=1
参数说明:num_iid:淘宝商品ID
is_promotion:是否获取取促销价
响应参数
Version: Date:2022-04-04
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item |
item[] | 1 | 宝贝详情数据 |
返回数据示例
{
"item": {
"num_iid": "520813250866",
"title": "三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮",
"desc_short": "",
"price": 25.8,
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "25.80",
"nick": "欢乐购客栈",
"num": "832",
"min_num": 0,
"detail_url": "http://item.taobao.com/item.htm?id=520813250866",
"pic_url": "//img.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg",
"brand": "三刃木",
"brandId": "4036703",
"rootCatId": "50013886",
"cid": "50014822",
"favcount": "4824",
"fanscount": "1469",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "<p style=\"text-align:center;\"><span style=\"color:#ff0000;\"><span style=\"font-size:24.0px;\"><strong>小店所有产品都支持刻字,如需刻字,拍之前联系客服即可。</strong></span></span></p> <p style=\"text-align:center;\"><span style=\"