淘宝/天猫平台商品详情API接口调用说明

正常为了进行电商平台淘宝/天猫的API接口调用，首先我们需要做下面几件事情：
1）开发者注册一个账号
2）然后为每个淘宝应用注册一个应用程序键（App Key)
3）下载淘宝/天猫API的SDK并掌握基本的API基础知识和调用
4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发
5）利用淘宝/天猫平台的文档中心API测试工具，对接口进行测试从而了解返回信息，方便程序获取。
6 ) 现无需以上五点，可直接点击注册获取Key和secret：
注册链接：http://console.open.onebound.cn/console/?i=lucy

公共参数:
名称 类型 必须 描述
key String 是 调用key
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 Bigint 545828993398 宝贝ID
title String 三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮 宝贝标题
desc_short String 商品简介
promotion_price Int 优惠价
price Float 25.8 价格
total_price Float 0
suggestive_price Float 0
orginal_price String 25.80 - 91.80 原价
nick String 欢乐购客栈lxq73061 掌柜昵称
num Int 3836 库存
min_num Int 0 最小购买数
detail_url String http://item.taobao.com/item.htm?id=545828993398 宝贝链接
pic_url String //gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg 宝贝图片
brand String 三刃木 品牌名称
brandId Int 8879363 品牌ID
rootCatId Int 50013886 顶级分类ID
cid Int 50014822
favcount Int 0
fanscount Int 0
crumbs Mix [] 导航菜单
created_time String
modified_time String
delist_time String
desc String
item_imgs Mix [{ “url”: “//gd3.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg”} 商品图片
item_weight String
item_size String
location String 发货地
express_fee Float 0.00 快递费用
ems_fee Float EMS费用
post_fee Float 物流费用
shipping_to String 发货至
has_discount Boolean false 是否有优惠
video Mix [{“pic”: “https://img.alicdn.com/imgextra/i4/1795410438/O1CN01ZORTQ01F6dyavtEur_!!1795410438.jpg”, “url”: “//cloud.video.taobao.com/play/u/1795410438/p/1/e/1/t/8/218504165570.swf”,“type”: “item”}] 商品视频
is_virtual String
sample_id String 商品风格标识ID
is_promotion Boolean false 是否促销
props_name String 1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子; 商品属性名
prop_imgs Mix {“prop_img”: [ {“properties”: “1627207:1347647754”, “url”: “//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg”}]} 商品属性图片列表
property_alias String 20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色 商品属性别名
props Mix [{ “name”: “产地”,“value”: “中国” }] 商品详情
total_sold Int
skus Mix {“sku”: [{“price”: “39”, “total_price”: null, “orginal_price”: “39.00”, “properties”: “1627207:1347647754”, “properties_name”: “1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子”, “quantity”: “305”, “sku_id”: “3166598625985”}] 商品规格信息列表
seller_id Int 41572778 卖家ID
sales Int 138 销量
shop_id Int 59943521 店铺ID
props_list Mix {20509:9974422: 尺码:36} 商品属性
seller_info Mix {“nick”: “欢乐购客栈”, “city”: null, “level”: 12, “bail”: “2000”, “rate”: 96, “score”: “4.8”, “delivery_score”: “4.8”, “item_score”: “4.8”, “shop_type”: null, “user_num_id”: “2596264565”, “sid”: “127203758”, “title”: “欢乐购客栈”, “zhuy”: “//shop127203758.taobao.com”, “company_name”: null, “menu”: [] } 卖家信息
tmall Boolean false 是否天猫
error String 错误信息
warning String price_json error;skus miss; 警告信息
url_log Mix []
method String item_tmall:pget_item
promo_type String
props_img Mix 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg 属性图片
shop_item Mix []
relate_items Mix []

错误码解释
状态代码(error_code) 状态信息 详细描述 是否收费

0000 success 接口调用成功并返回相关数据 是
2000 Search success but no result 接口访问成功，但是搜索没有结果 是
4000 Server internal error 服务器内部错误 否
4001 Network error 网络错误 否
4002 Target server error 目标服务器错误 否
4003 Param error 用户输入参数错误 否
4004 Account not found 用户帐号不存在 否
4005 Invalid authentication credentials 授权失败 否
4006 API stopped 您的当前API已停用 否
4007 Account stopped 您的账户已停用 否
4008 API rate limit exceeded 并发已达上限 否
4009 API maintenance API维护中 否
4010 API not found with these values API不存在 否
4012 Please add api first 请先添加api 否
4013 Number of calls exceeded 调用次数超限 否
4014 Missing url param 参数缺失 否
4015 Wrong pageToken 参数pageToken有误 否
4016 Insufficient balance 余额不足 否
4017 timeout error 请求超时 否
5000 unknown error 未知错误 否