API的常识，商品详情数据对接
原则上API接口设计一般出现在开发的详细设计中，但是随着诸多公司建立开放平台，产品经理也逐渐需要能理解API接口，尤其是做平台性的产品，还要学会定义接口。本文就关于产品经理在设计接口中需要定义什么、需要注意什么来展开陈述。
调用第三方平台接口需要进行系统间的通信，目前常用的协议是http和https;简单理解https是http的加密版，可以将用户到服务端请求的信息进行加密，避免因明文传输被截获而获知用户信息。
接口的请求方式
了解接口的请求方式有助于了解用户端和服务端间的交互方式，基于http协议的常用请求方式是post和get;两者的主要区别如下：
(1)直观区别：get请求方式是将请求参数放到url中，post是将参数放到requst body中，所带来的的直接影响是get的请求参数存在长度限制，post无限制;其次是get将参数放到url中安全性弱于post;
(2)深度区别：get请求方式用户端和服务端只产生一次交互，post请求方式用户端会和服务端产生两次交互，举例：快递小哥是用户端，你是服务端，则get就像常来你们小区和你认识的快递员直接将快件送到你家，你跟他说声谢谢;post就像新来的快递员先打个电话问下你在家吗?你告诉他你在家呢，过了5分钟他将快递送到你家了，你跟他说声谢谢;
item_get-获得淘宝商品详情
公共参数
请求地址: https://o0b.cn/anzexi
名称类型必须描述keyString是调用key（必须以GET方式拼接在URL中）secretString是调用密钥api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读langString否[cn,en,ru]翻译语言，默认cn简体中文versionString否API版本
请求参数
请求参数：num_iid=652874751412&is_promotion=1
参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价
响应参数
Version: Date:2022-04-04
名称类型必须示例值描述itemitem[]1宝贝详情数据num_iidBigint1520813250866宝贝IDtitleString1三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮宝贝标题desc_shortString0商品简介promotion_priceInt0优惠价priceFloat125.8价格total_priceFloat00suggestive_priceFloat00orginal_priceString025.80原价nickString0欢乐购客栈掌柜昵称numInt03836库存min_numInt00最小购买数detail_urlString0http://item.taobao.com/item.htm?id=520813250866宝贝链接pic_urlString1//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg宝贝图片brandString0三刃木品牌名称brandIdInt08879363品牌IDrootCatIdInt050013886顶级分类IDcidInt150014822crumbsMix0[]导航菜单created_timeString0modified_timeString0delist_timeString0descString0商品详情desc_imgMix0[]商品详情图片item_imgsMix0item_imgs[]商品图片item_weightString0item_sizeString0locationString0发货地express_feeFloat00.00快递费用ems_feeFloat0EMS费用post_feeFloat0物流费用shipping_toString0发货至has_discountBoolean0false是否有优惠videovideo[]0商品视频is_virtualString0sample_idString0商品风格标识IDis_promotionBoolean0false是否促销props_nameString01627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。prop_imgsprop_imgs[]0商品属性图片列表property_aliasString020509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。propsMix0[{ "name": "产地","value": "中国" }]商品属性total_soldInt0skusskus[]0商品规格信息列表seller_idInt02844096782卖家IDsalesInt0138销量shop_idInt0151372205店铺IDprops_listMix0{20509:9974422: 尺码:36}商品属性seller_infoseller_info[]1卖家信息tmallBoolean0false是否天猫errorString0错误信息warningString0警告信息url_logMix0[]favcountInt00fanscountInt00methodString0item_tmall:pget_itempromo_typeString0props_imgMix01627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg属性图片shop_itemMix0[]relate_itemsMix0[]
请求示例Curl PHP PHPsdk JAVA C# Python
-- 请求示例 url 默认请求参数已经URL编码处理curl -i "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412&is_promotion=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="font-size:18.0px;"><strong>炎炎夏日来临，一把随身携带便携式的折叠小刀，<span style="color:#ff0000;">带开瓶器功能</span>，喝酒不用愁。（钥匙刀不带开瓶器功能）</strong></span></p> <p style="text-align:center;"><strong style="color:#000000;line-height:1.5;"><span style="font-size:18.0px;"><span style="line-height:18.0px;">可以当吊牌项链装饰，也可当钥匙扣挂饰， 水果刀 开瓶器 户外防身.</span></span></strong></p> <p style="text-align:center;"><strong style="line-height:1.5;"><span style="font-size:24.0px;">部分客户跟我们反映链子质量还不够好，因此小店已重新订购一批质量更好的链子赠送，<span style="color:#ff0000;">加量不加价</span>，只为让你买的更舒心，戴的更放心。</span></strong></p> <p style="text-align:center;"><span style="font-size:36.0px;"><strong>购买就送<span style="color:#ff0000;">工具刀卡和链子</span>一条</strong></span></p> <p style="text-align:center;"><span style="font-size:36.0px;"><strong><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2Sci2jXXXXXXFXpXXXXXXXXXX_!!2596264565.png" size="611x442"> </strong></span></p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>璀璨钻石套餐包含【SK016D钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg" size="750x600" /></p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>超凡大师套餐包括【304不锈钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><a href="//item.taobao.com/item.htm?id=520798805877" target="_blank"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="float:none;margin:0.0px;" /></a></p> <p style="text-align:center;"> </p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>最强王者套餐包括【钛钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】<a href="//item.taobao.com/item.htm?id=520801586805" target="_blank"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="float:none;margin:0.0px;" /></a> </strong></span></p> <p style="text-align:center;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB28Ox4b77OyuJjSsplXXXqdpXa_!!2596264565.jpg" size="749x553"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2.mTddVXXXXbeXpXXXXXXXXXX_!!2596264565.jpg" style="line-height:1.5;" size="750x653"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB21Ro.jl0lpuFjSszdXXcdxFXa_!!2596264565.jpg" size="750x653"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2q9CelVXXXXcUXXXXXXXXXXXX_!!2596264565.jpg" size="750x340"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB21EX9lVXXXXaXXpXXXXXXXXXX_!!2596264565.jpg" size="750x416"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2udCylVXXXXXgXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2EARxjB8lpuFjSspaXXXJKpXa_!!2596264565.jpg" size="750x515"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2ssuwlVXXXXafXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2nAHqgyC9MuFjSZFoXXbUzFXa_!!2596264565.jpg" size="750x606"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2ahCelVXXXXc_XXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2w1JnjwRkpuFjy1zeXXc.6FXa_!!2596264565.jpg" size="750x469"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2C902lVXXXXbnXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2sGR3lVXXXXblXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2ZBGxlVXXXXXMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2MjWklVXXXXcaXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2UgV3lVXXXXbdXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2ip5XlVXXXXX2XpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2sMTBdVXXXXXlXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2d3HfdVXXXXahXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2AVbBdVXXXXXkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2nf_wdVXXXXaMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2dLYddVXXXXbtXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2H1_adVXXXXbWXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2eBzsdVXXXXbuXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2dOTndVXXXXcCXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2fK2tdVXXXXbkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB29zjedVXXXXaFXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2i7rmdVXXXXcTXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;" /></p>",
"item_imgs": [
{
"url": "//img.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/2596264565/TB2onxRlVXXXXcDXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i1/2596264565/TB2a.x.lVXXXXXPXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/2596264565/TB2iWE6bKZkyKJjSszbXXblwFXa_!!2596264565.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i4/2596264565/TB2j2cTXib_F1JjSZFzXXc6KXXa_!!2596264565.jpg"
}
],
"item_weight": "0", "item_size": "", "location": "广东深圳", "post_fee": "", "express_fee": "0.00", "ems_fee": "", "shipping_to": "广东广州白云区", "has_discount": "false", "video": [], "is_virtual": "", "sample_id": "", "is_promotion": "false", "props_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子;1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】;1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】;1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】", "prop_imgs": {
"prop_img": [
{
"properties": "1627207:1347647754", "url": "//img.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"properties": "1627207:1347647753", "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"properties": "1627207:1195392087", "url": "//img.alicdn.com/imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg"
},
{
"properties": "1627207:1331112595", "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg"
},
{
"properties": "1627207:1331112594", "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg"
},
{
"properties": "1627207:1331264247", "url": "//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"
}
]
},
"property_alias": "1627207:1347647754:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:椭圆形带开瓶器+送工具刀卡+链子;1627207:1195392087:GJ018X钥匙刀+送工具刀卡+链子;1627207:1331112595:超凡大师套餐【送工具卡+链子】;1627207:1331112594:最强王者套餐【送工具卡+链子】;1627207:1331264247:璀璨钻石套餐【送工具卡+链子】", "props": [
{
"name": "品牌", "value": "三刃木"
},
{
"name": "产地", "value": "中国"
},
{
"name": "颜色分类", "value": "长方形带开瓶器+送工具刀卡+链子,椭圆形带开瓶器+送工具刀卡+链子,GJ018X钥匙刀+送工具刀卡+链子,超凡大师套餐【送工具卡+链子】,最强王者套餐【送工具卡+链子】,璀璨钻石套餐【送工具卡+链子】"
},
{
"name": "吊牌价", "value": "46"
},
{
"name": "功能数量", "value": "5个及以下"
},
{
"name": "货号", "value": "GJ019C"
},
{
"name": "附加功能", "value": "开瓶器,刀,螺丝刀,钥匙圈,其他"
}
],
"total_sold": "1", "skus": {
"sku": [
{
"price": "39", "orginal_price": "39.00", "properties": "1627207:1347647754", "properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子", "quantity": "104", "sku_id": "3166598625985"
},
{
"price": "39", "orginal_price": "39.00", "properties": "1627207:1347647753", "properties_name": "1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子", "quantity": "370", "sku_id": "3166598625984"
},
{
"price": "25.8", "orginal_price": "25.80", "properties": "1627207:1195392087", "properties_name": "1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子", "quantity": "34", "sku_id": "3144644292458"
},
{
"price": "73.8", "orginal_price": "73.80", "properties": "1627207:1331112595", "properties_name": "1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】", "quantity": "157", "sku_id": "3161300228970"
},
{
"price": "91.8", "orginal_price": "91.80", "properties": "1627207:1331112594", "properties_name": "1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】", "quantity": "0", "sku_id": "3161300228969"
},
{
"price": "63.8", "orginal_price": "63.80", "properties": "1627207:1331264247", "properties_name": "1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】", "quantity": "167", "sku_id": "3161107666655"
}
]
},
"seller_id": "2596264565", "sales": "1", "shop_id": "127203758", "props_list": {
"1627207:1347647754": "颜色分类:长方形带开瓶器+送工具刀卡+链子",
"1627207:1347647753": "颜色分类:椭圆形带开瓶器+送工具刀卡+链子",
"1627207:1195392087": "颜色分类:GJ018X钥匙刀+送工具刀卡+链子",
"1627207:1331112595": "颜色分类:超凡大师套餐【送工具卡+链子】",
"1627207:1331112594": "颜色分类:最强王者套餐【送工具卡+链子】",
"1627207:1331264247": "颜色分类:璀璨钻石套餐【送工具卡+链子】"
},
"seller_info": {
"title": "欢乐购客栈",
"shop_name": "欢乐购客栈",
"sid": "127203758",
"zhuy": "//shop127203758.taobao.com",
"level": "12",
"shop_type": "C",
"user_num_id": "2596264565",
"nick": "欢乐购客栈",
"cid": null,
"delivery_score": "4.8 ",
"item_score": "4.8 ",
"score_p": "4.8 "
},
"tmall": "false",
"error": "",
"warning": "",
"url_log": [],
"stuff_status": "",
"shopinfo": {
"shop_name": "欢乐购客栈",
"shop_id": "127203758"
},
"data_from": "mtop",
"method": "item_mtop:item_get",
"promo_type": null,
"props_img": {
"1627207:1347647754": "//img.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg",
"1627207:1347647753": "//img.alicdn.com/imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg",
"1627207:1195392087": "//img.alicdn.com/imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg",
"1627207:1331112595": "//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg",
"1627207:1331112594": "//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg",
"1627207:1331264247": "//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"
},
