电商API科普帖，让你读完秒懂

末蓝、 2024-03-26 15:21 60阅读 0赞

### 电商API是什么？ ###

API是application programming interface（应用程序接口）的简称，是一些预先定义的函数。目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

电商API是服务电商的API 接口，一般有淘宝、天猫、1688、京东、亚马逊等国内外主流电商平台，API接口一般有获取商品详情、购买物、关键词搜索、获取店铺所有商品、物流信息、订单信息等。

### 常见的电商平台有哪些？ ###

随着诸如物联网（IoT），人工智能（AI），增强现实/虚拟现实（AR /VR）以及区块链等技术的兴起，电商平台也是越来越多。**境内外电商平台主要有**：淘宝、1688、京东、拼多多、当当、京东、唯品会、蘑菇街、一号店、阿里巴巴、阿里妈妈、苏宁、亚马逊、易贝、搜好货、微店、速卖通、网易考拉、洋码头、Lazada、凡客、淘宝客、义乌购、虾皮、聚美优品、慧聪网、搜了网、小红书、电子元件、17网、货铺头等。

### **电商平台开放数据主要有哪些？** ###

商品详情、商品评论、商品快递费用、淘口令真实url、商品上下架时间、店铺详情、关键字搜索商品、按图搜索商品（拍立淘）、获得店铺所有商品、搜索店铺列表、获得搜索词推荐、天天特价、优惠券查询、淘宝商品类目、搜索同款商品、获取sku详细信息、获取品牌分类列表、得到指定关键词的品牌列表添加到购物车、删除购物车商品、清空购物车商品、将购物车商品保存为订单、获取购买到的商品订单列表、获得购买到的商品订单物流、获取购买到的订单买家留言、收货地址列表、清除收货地址、删除/修改收货地址、添加收货地址、买家信息、获取卖出的商品订单详情、卖家关闭一笔交易、获取或修改卖出去的订单备注、商品可上下架商品列表、商品上下架、商品上传、上传图片到淘宝、图片识别商品接口、淘宝客订单查询、批量获取商品信息、获取商品历史价格信息、获取APP商品详情原数据。

### 需要授权的API数据有哪些？ ###

*  buyer\_cart\_add 添加到购物车

*  buyer\_cart\_remove 删除购物车商品

*  buyer\_cart\_clear 清空购物车

*  buyer\_cart\_list 获取购物车的商品列表

*  buyer\_cart\_order 将购物车商品保存为订单

*  buyer\_order\_list 获取购买到的商品订单列表

*  buyer\_order\_detail 获取购买到的商品订单详情

*  buyer\_order\_express 获取购买到的商品订单物流

*  buyer\_order\_message 获取购买到的订单买家留言

*  buyer\_address\_list 收货地址列表

*  buyer\_address\_clear 清除收货地址

*  buyer\_address\_remove 删除收货地址

*  buyer\_address\_modify 修改收货地址

*  buyer\_address\_add 添加收货地址

*  buyer\_info 买家信息

*  buyer\_token 买家token

*  seller\_order\_list 获取卖出的商品订单列表

*  seller\_order\_detail 获取卖出的商品订单详情

*  seller\_order\_close 卖家关闭一笔交易

*  seller\_order\_message 获取或修改卖出去的订单备注

*  seller\_auction\_list 商品可上下架商品列表

*  seller\_auction 商品上下架

*  seller\_item\_add 商品上传

### API调用说明 ###

#### 传入参数-公共参数 ####

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:160px;vertical-align:bottom;height:52px;">名称</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">类型</td> 
 <td style="width:160px;vertical-align:bottom;height:52px;">必须</td> 
 <td style="width:321px;vertical-align:bottom;height:52px;">描述</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">key</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用key（<a style="color:#0A6CFF;" href="https://o0b.cn/jennif" rel="nofollow">API调用测试</a>）</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">secret</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用密钥</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">api_name</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">cache</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">result_type</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">lang</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">version</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API版本</td> 
 </tr> 
 </tbody> 
</table>

#### 请求参数 ####

具体API的请求参数不同，商品详情接口的请求参数为商品ID。

num\_iid=652874751412&is\_promotion=1

参数说明：num\_iid:淘宝商品ID

is\_promotion:是否获取取促销价

#### 响应示例 ####

{
 "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": "小店所有产品都支持刻字，如需刻字，拍之前联系客服即可。 炎炎夏日来临，一把随身携带便携式的折叠小刀，带开瓶器功能，喝酒不用愁。（钥匙刀不带开瓶器功能） 可以当吊牌项链装饰，也可当钥匙扣挂饰， 水果刀 开瓶器 户外防身. 部分客户跟我们反映链子质量还不够好，因此小店已重新订购一批质量更好的链子赠送，加量不加价，只为让你买的更舒心，戴的更放心。 购买就送工具刀卡和链子一条 <img align=\"absmiddle\" src=\"//img.alicdn.com/imgextra/i3/2596264565/TB2Sci2jXXXXXXFXpXXXXXXXXXX_!!2596264565.png\" size=\"611x442\"> 璀璨钻石套餐包含【SK016D钥匙扣+GJ019C折叠刀+GJ017D工具卡】<img align=\"absmiddle\" src=\"//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg\" size=\"750x600\" /> 超凡大师套餐包括【304不锈钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】<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>   最强王者套餐包括【钛钢钥匙扣+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> <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;\" />",
 "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"
 }