API 接口获得店铺商品商品详情返回值说明

一、获取淘宝卖家店铺订单背景：

订单是卖家的核心数据，卖家的很多日常工作都是围绕着订单展开，应用的基本功能就是要保证订单实时、完整的展示在卖家面前。由于API请求依赖于网络，存在 着网络不稳定和同步时间长的问题，所以应用必须把淘宝的订单数据同步到本地。如何才能快速、完整的把订单同步到本地是本方案将要讨论的问题。

二、名词解释：

1、在线订单：卖家三个月内已卖出的订单。

2、增量订单：相对已经同步到本地的订单，凡是在淘宝上发生了变更的订单就是增量订单。

3、消息服务：一种通过HTTP长连接实时向客户端（应用）推送数据（交易）变更的渠道。

三、API介绍

taobao.trades.sold.get - 获取三个月内已卖出的在线订单，适用于用户初始化的时候使用，ISV不应该用此接口来获取增量订单。不建议使用或尽量少用此接口。taobao.trades.sold.increment.get – 获取增量订单，适用于用户初始化后，增量同步发生变更的订单，ISV不应该用此接口来获取三个月内的订单。taobao.trade.fullinfo.get - 获取单笔订单详情。

四、实施方案

订单同步主要分为初始化和增量获取两个步骤：

1、初始化是把3个月内的在线订单全部同步回来，这个需要较长的时间；

2、增量获取则是把淘宝发生了变更的订单同步回来，这个一般需要较短的时间。

五、响应参数

六、代码展示

{"item": {"num_iid": "520813250866","title": "三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮","desc_short": "","price": "25.8","total_price": "","suggestive_price": "","orginal_price": "25.80","nick": "欢乐购客栈","num": 16840,"detail_url": "/item.htm?id=520813250866","pic_url": "///imgextra/i4/2596264565/O1CN01mbmuAB1jaogMUWhv8_!!2596264565.jpg","brand": "三刃木","brandId": "4036703","rootCatId": "50013886","cid": "50014822","desc": "\n <p ><span ><span ><strong>小店所有产品都支持刻字，如需刻字，拍之前联系客服即可。</strong></span></span></p> \n <p ><span ><strong>炎炎夏日来临，一把随身携带便携式的折叠小刀，<span >带开瓶器功能</span>，喝酒不用愁。（钥匙刀不带开瓶器功能）</strong></span></p> \n <p ><strong ><span ><span >可以当吊牌项链装饰，也可当钥匙扣挂饰， 水果刀 开瓶器 户外防身.</span></span></strong></p> \n <p ><strong ><span >部分客户跟我们反映链子质量还不够好，因此小店已重新订购一批质量更好的链子赠送，<span >加量不加价</span>，只为让你买的更舒心，戴的更放心。</span></strong></p> \n <p ><span ><strong>购买就送<span >工具刀卡和链子</span>一条</strong></span></p> \n <p ><span ><strong><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2Sci2jXXXXXXFXpXXXXXXXXXX_!!2596264565.png\" /> </strong></span></p> \n <p ><span ><strong>璀璨钻石套餐包含【SK016D钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg\" /></p> \n <p ><span ><strong>超凡大师套餐包括【304不锈钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /></p> \n <p >&nbsp;</p> \n <p ><span ><strong>最强王者套餐包括【钛钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】<img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /> </strong></span></p> \n <p ><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB28Ox4b77OyuJjSsplXXXqdpXa_!!2596264565.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i1/2596264565/TB2.mTddVXXXXbeXpXXXXXXXXXX_!!2596264565.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB21Ro.jl0lpuFjSszdXXcdxFXa_!!2596264565.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2q9CelVXXXXcUXXXXXXXXXXXX_!!2596264565.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB21EX9lVXXXXaXXpXXXXXXXXXX_!!2596264565.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2udCylVXXXXXgXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i1/2596264565/TB2EARxjB8lpuFjSspaXXXJKpXa_!!2596264565.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2ssuwlVXXXXafXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2nAHqgyC9MuFjSZFoXXbUzFXa_!!2596264565.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2ahCelVXXXXc_XXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2w1JnjwRkpuFjy1zeXXc.6FXa_!!2596264565.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2C902lVXXXXbnXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i1/2596264565/TB2sGR3lVXXXXblXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i1/2596264565/TB2ZBGxlVXXXXXMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i1/2596264565/TB2MjWklVXXXXcaXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2UgV3lVXXXXbdXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2ip5XlVXXXXX2XpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /> <img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2sMTBdVXXXXXlXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2d3HfdVXXXXahXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2AVbBdVXXXXXkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2nf_wdVXXXXaMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2dLYddVXXXXbtXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2H1_adVXXXXbWXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2eBzsdVXXXXbuXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i4/2596264565/TB2dOTndVXXXXcCXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB2fK2tdVXXXXbkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i2/2596264565/TB29zjedVXXXXaFXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /><img align=\"absmiddle\" src=\"/imgextra/i3/2596264565/TB2i7rmdVXXXXcTXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg\" /></p>\n ","item_imgs": [{"url": "///imgextra/i4/2596264565/O1CN01mbmuAB1jaogMUWhv8_!!2596264565.jpg"},{"url": "///imgextra/i3/2596264565/O1CN01dVHKvp1jaogIQyUBv_!!2596264565.jpg"},{"url": "///imgextra/i1/2596264565/TB2a.x.lVXXXXXPXpXXXXXXXXXX_!!2596264565.jpg"},{"url": "///imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg"},{"url": "///imgextra/i4/2596264565/TB2j2cTXib_F1JjSZFzXXc6KXXa_!!2596264565.jpg"}],"item_weight": "","post_fee": "","express_fee": null,"ems_fee": "","shipping_to": "","video": [],"sample_id": "","props_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子;1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】;1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】;1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】","prop_imgs": {"prop_img": [{"properties": "1627207:1347647754","url": "///imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1347647753","url": "///imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1195392087","url": "///imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331112595","url": "///imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331112594","url": "///imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331264247","url": "///imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"}]},"props_imgs": {"prop_img": [{"properties": "1627207:1347647754","url": "///imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1347647753","url": "///imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1195392087","url": "///imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331112595","url": "///imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331112594","url": "///imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg"},{"properties": "1627207:1331264247","url": "///imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"}]},"property_alias": "","props": [{"name": "品牌","value": "三刃木"},{"name": "产地","value": "中国"},{"name": "颜色分类","value": "长方形带开瓶器+送工具刀卡+链子,椭圆形带开瓶器+送工具刀卡+链子,GJ018X钥匙刀+送工具刀卡+链子,超凡大师套餐【送工具卡+链子】,最强王者套餐【送工具卡+链子】,璀璨钻石套餐【送工具卡+链子】"},{"name": "吊牌价","value": "46"},{"name": "功能数量","value": "5个及以下"},{"name": "货号","value": "GJ019C"},{"name": "附加功能","value": "开瓶器,刀,螺丝刀,钥匙圈,其他"}],"total_sold": "10","skus": {"sku": [{"price": "39","total_price": 0,"orginal_price": "39","properties": "1627207:1347647754","properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子","quantity": "9579","sku_id": "3166598625985"},{"price": "39","total_price": 0,"orginal_price": "39","properties": "1627207:1347647753","properties_name": "1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子","quantity": "3699","sku_id": "3166598625984"},{"price": "25.8","total_price": 0,"orginal_price": "25.8","properties": "1627207:1195392087","properties_name": "1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子","quantity": "3399","sku_id": "3144644292458"},{"price": "73.8","total_price": 0,"orginal_price": "73.8","properties": "1627207:1331112595","properties_name": "1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】","quantity": "0","sku_id": "3161300228970"},{"price": "91.8","total_price": 0,"orginal_price": "91.8","properties": "1627207:1331112594","properties_name": "1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】","quantity": "0","sku_id": "3161300228969"},{"price": "63.8","total_price": 0,"orginal_price": "63.8","properties": "1627207:1331264247","properties_name": "1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】","quantity": "163","sku_id": "3161107666655"}]},"seller_id": "2596264565","sales": 13,"shop_id": "127203758","props_list": {"1627207:1347647754": "颜色分类:长方形带开瓶器+送工具刀卡+链子","1627207:1347647753": "颜色分类:椭圆形带开瓶器+送工具刀卡+链子","1627207:1195392087": "颜色分类:GJ018X钥匙刀+送工具刀卡+链子","1627207:1331112595": "颜色分类:超凡大师套餐【送工具卡+链子】","1627207:1331112594": "颜色分类:最强王者套餐【送工具卡+链子】","1627207:1331264247": "颜色分类:璀璨钻石套餐【送工具卡+链子】"},"seller_info": {"nick": "欢乐购客栈","item_score": "4.8 ","score_p": "4.8 ","delivery_score": "4.8 ","shop_type": "C","user_num_id": "2596264565","sid": "127203758","title": "欢乐购客栈","zhuy": "/","shop_name": "欢乐购客栈"},"tmall": false,"error": "","fav_count": "4824","fans_count": "1462","location": "广东深圳","data_from": "server","props_img": {"1627207:1347647754": "///imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg","1627207:1347647753": "///imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg","1627207:1195392087": "///imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg","1627207:1331112595": "///imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg","1627207:1331112594": "///imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg","1627207:1331264247": "///imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"},"desc_img": ["/imgextra/i3/2596264565/TB2Sci2jXXXXXXFXpXXXXXXXXXX_!!2596264565.png","/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg","/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i3/2596264565/TB28Ox4b77OyuJjSsplXXXqdpXa_!!2596264565.jpg","/imgextra/i1/2596264565/TB2.mTddVXXXXbeXpXXXXXXXXXX_!!2596264565.jpg","/imgextra/i3/2596264565/TB21Ro.jl0lpuFjSszdXXcdxFXa_!!2596264565.jpg","/imgextra/i4/2596264565/TB2q9CelVXXXXcUXXXXXXXXXXXX_!!2596264565.jpg","/imgextra/i3/2596264565/TB21EX9lVXXXXaXXpXXXXXXXXXX_!!2596264565.jpg","/imgextra/i3/2596264565/TB2udCylVXXXXXgXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i1/2596264565/TB2EARxjB8lpuFjSspaXXXJKpXa_!!2596264565.jpg","/imgextra/i3/2596264565/TB2ssuwlVXXXXafXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2nAHqgyC9MuFjSZFoXXbUzFXa_!!2596264565.jpg","/imgextra/i3/2596264565/TB2ahCelVXXXXc_XXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i3/2596264565/TB2w1JnjwRkpuFjy1zeXXc.6FXa_!!2596264565.jpg","/imgextra/i3/2596264565/TB2C902lVXXXXbnXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i1/2596264565/TB2sGR3lVXXXXblXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i1/2596264565/TB2ZBGxlVXXXXXMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i1/2596264565/TB2MjWklVXXXXcaXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2UgV3lVXXXXbdXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2ip5XlVXXXXX2XpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2sMTBdVXXXXXlXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i3/2596264565/TB2d3HfdVXXXXahXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i4/2596264565/TB2AVbBdVXXXXXkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2nf_wdVXXXXaMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i4/2596264565/TB2dLYddVXXXXbtXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2H1_adVXXXXbWXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2eBzsdVXXXXbuXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i4/2596264565/TB2dOTndVXXXXcCXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB2fK2tdVXXXXbkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i2/2596264565/TB29zjedVXXXXaFXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg","/imgextra/i3/2596264565/TB2i7rmdVXXXXcTXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"]},"secache": "7e721ad79194b06c2a7fea78e07f87be","secache_time": 1608166332,"secache_date": "-12-17 08:52:12","translate_status": "","translate_time": 0,"language": {"default_lang": "cn","current_lang": "cn"},"error": "","reason": "","error_code": "0000","cache": 0,"api_info": "today:2 max:10000","execution_time": 0.924,"server_time": "Beijing/-12-17 08:52:12","client_ip": "192.168.16.172","call_args": {"num_iid": "520813250866"},"api_type": "taobao","translate_language": "zh-CN","translate_engine": "google_cn","server_memory": "6.83MB","request_id": "2.5fdaabbb7e07f"}

获取测试key和secret

如果觉得《API 接口获得店铺商品商品详情返回值说明》对你有帮助，请点赞、收藏，并留下你的观点哦！