作为电商API专家,对各大电商平台的API接口都有深入的了解,包括微店micro的电商API。以下是微店micro电商API的部分接口及其主要功能:
- 商品信息API接口:
- 主要功能:允许商家快速获取商品信息,如商品ID、标题、价格、库存、图片等。这些数据可用于在商家自己的应用程序或网站中展示商品,实现购买和下单功能。
此API目前支持以下基本接口:
- item_search 根据关键词取商品列表
- item_search_shop 获得店铺的所有商品
- 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版本 |
请求参数
请求参数:q=女装&page=
参数说明:q:关键词, page:页码
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title | String | 0 | HYKE x The North Face北面tnf联名中长款面包服羽绒服秋冬加厚保暖情侣外套 | 商品标题 |
num_iid | String | 0 | 3490287840 | 宝贝ID |
price | Float | 0 | 799 | 价格 |
orginal_price | Float | 0 | 799 | 原价格 |
promotion_price | Float | 0 | 799 | 优惠价格 |
pic_url | String | 0 | https://si.geilicdn.com/pcitem1232497572-78fb000001765d42a8050a217205-unadjust_958_958.jpeg | 宝贝图片 |
sales | Int | 0 | 14830 | 销量 |
seller_id | String | 0 | 卖家ID | |
seller_nick | String | 0 | 掌柜昵称 | |
detail_url | String | 0 | https://weidian.com/item.html?itemID=3490287840 | 宝贝链接 |
部分响应示例
{
"items": {
"q": "女装",
"page": 1,
"page_size": 100,
"real_total_results": 10000,
"total_results": 10000,
"pagecount": 100,
"data_from": "micro",
"item": [
{
"title": "HYKE x The North Face北面tnf联名中长款面包服羽绒服秋冬加厚保暖情侣外套",
"num_iid": 3490287840,
"price": 799,
"orginal_price": 799,
"promotion_price": 799,
"pic_url": "https://si.geilicdn.com/pcitem1232497572-78fb000001765d42a8050a217205-unadjust_958_958.jpeg",
"sales": 43,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3490287840"
},
{
"title": "Sup联名牛仔衣外套supreme联名驴牌牛仔外套 1v牛仔外套 驴牛仔外套 1v夹克 牛仔夹克\n",
"num_iid": 3470898024,
"price": 799,
"orginal_price": 799,
"promotion_price": 799,
"pic_url": "https://si.geilicdn.com/wdseller1515987046-618f000001754f6b1b950a217205_1080_1350.jpg?w=1125",
"sales": 1131,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3470898024"
},
{
"title": "Nike Classic X Sport 姜黄色两面穿棉服 男女情侣秋冬宽松保暖夹克外套",
"num_iid": 3495394879,
"price": 249,
"orginal_price": 249,
"promotion_price": 249,
"pic_url": "https://si.geilicdn.com/pcitem1232497572-35fd0000017653c8ba180a217205-unadjust_800_799.jpeg",
"sales": 25,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3495394879"
},
{
"title": "【专柜正品】Adidas阿迪达斯外套女安琪拉 运动休闲上衣三叶草加绒加厚夹克毛呢情侣甜心小熊开衫卫衣元素棉衣EE7399",
"num_iid": 3991988902,
"price": 239,
"orginal_price": 239,
"promotion_price": 239,
"pic_url": "https://si.geilicdn.com/pcitem207866614-4c3900000174cee115db0a217205_1088_1330.jpg",
"sales": 47,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3991988902"
},
{
"title": "Burbe*ry 19秋冬新款,王牌代工真品!新式螺纹撞色设计,60%羊毛30%羊绒打造,情侣款圆领套头毛衣",
"num_iid": 2973285371,
"price": 338,
"orginal_price": 338,
"promotion_price": 338,
"pic_url": "https://si.geilicdn.com/wdseller982250730-43d900000173c514cc560a21348d_1124_842.jpg",
"sales": 396,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=2973285371"
},
{
"title": "小香家牛货~满满高级感!系带针织开衫大衣\n",
"num_iid": 3993498117,
"price": 1680,
"orginal_price": 1680,
"promotion_price": 1680,
"pic_url": "https://si.geilicdn.com/wdseller901474021863-4e7100000174d340ee750a217216_1440_1920.jpg?w=750",
"sales": 1,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3993498117"
},
{
"title": "剪刀手大毛领长款厚实保暖女士鹅绒服羽绒服外套",
"num_iid": 4246323440,
"price": 868,
"orginal_price": 868,
"promotion_price": 868,
"pic_url": "https://si.geilicdn.com/weidian1496872223-5ae40000017666eebb1f0a20b7b9_560_800.jpg",
"sales": 8,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4246323440"
},
{
"title": "207806.L*P家秋冬水貂镶边连帽2色斗篷大衣\n",
"num_iid": 4253675526,
"price": 3390,
"orginal_price": 3390,
"promotion_price": 3390,
"pic_url": "https://si.geilicdn.com/wdseller901353083325-4d180000017683f22f780a21348d-unadjust_1124_1438.jpeg",
"sales": 1,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4253675526"
},
{
"title": "百分百zp订单!gu@cci 千格鸟高级成衣套装 外套➕半身裙!贵妇和仙女们都可以get起来",
"num_iid": 3932701598,
"price": 1050,
"orginal_price": 1050,
"promotion_price": 1050,
"pic_url": "https://si.geilicdn.com/wdseller1419679334-02bb00000174498548c50a217216_1080_1440.jpg?w=1242",
"sales": 22,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3932701598"
},
{
"title": "The North Face北面羽绒服男女同款2020新款秋冬短款外套女羽绒服联名Jacket脑死亡",
"num_iid": 4036752883,
"price": 599.9,
"orginal_price": 599.9,
"promotion_price": 599.9,
"pic_url": "https://si.geilicdn.com/wdseller708662266-25fa00000176cd7f210d0a21c2a7_1242_1239.jpg",
"sales": 756,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4036752883"
},
{
"title": "【0115上新地素da/zzle 21年早春新款z】实力渠道!合作地素da/zzle 21年早春新款亮片毛衣",
"num_iid": 4278540307,
"price": 318,
"orginal_price": 318,
"promotion_price": 318,
"pic_url": "https://si.geilicdn.com/weidian901528394022-6da70000017700e6dfb00a20b7b9_1080_1431.jpg",
"sales": 355,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4278540307"
},
{
"title": "硬货 来晚了 纯纯纯正单 马克思maxmara羊绒大衣经典款情侣冬季风衣101801呢子服",
"num_iid": 3028848079,
"price": 2580,
"orginal_price": 2580,
"promotion_price": 2580,
"pic_url": "https://si.geilicdn.com/wdseller1356285568-7a8200000175ad2fab750a217216-unadjust_1242_1242.jpeg",
"sales": 351,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3028848079"
},
{
"title": "【嘟嘟推荐】重磅‼️皮草夫妇👉Mr&Mrs Italy MMI女士皮草派克大衣外套(下单前可带图咨询嘟嘟)",
"num_iid": 3027934363,
"price": 4400,
"orginal_price": 4400,
"promotion_price": 4400,
"pic_url": "https://si.geilicdn.com/weidian1419679334-29e30000016ddc7776f60a21c2a7_1440_1920.jpg",
"sales": 53,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3027934363"
},
{
"title": "THE NORTH FACE北面潮牌羽绒服男女同款短款外套女羽绒服情侣装1996Nuptse经典复刻",
"num_iid": 4075831084,
"price": 599.9,
"orginal_price": 599.9,
"promotion_price": 599.9,
"pic_url": "https://si.geilicdn.com/wdseller708662266-2ee000000176e28c0b6e0a217205_800_800.jpg",
"sales": 464,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4075831084"
},
{
"title": "【年底狂欢购】蒙口家liriope 20F/W 新款女士亮面连帽短款羽绒服外套,袁姗姗同款",
"num_iid": 4261382075,
"price": 886.44,
"orginal_price": 886.44,
"promotion_price": 886.44,
"pic_url": "https://si.geilicdn.com/pcitem1322063473-7f2000000176ac8a4bc40a21348d-unadjust_1080_1080.jpeg",
"sales": 219,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4261382075"
},
{
"title": "20年秋冬季新款外贸女装纯棉加绒圆领卫衣休闲运动服刺绣套衫女",
"num_iid": 3547970105,
"price": 108,
"orginal_price": 108,
"promotion_price": 108,
"pic_url": "https://si.geilicdn.com/wdseller328987272-27c8000001771ab9a2e50a217216_1080_1018.jpg",
"sales": 34,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3547970105"
},
{
"title": "Acne新款【19秋冬新款】女士新品短款双排扣羊毛混纺双面呢外套两色舒适 廓形宽松版型女外套羊毛大衣",
"num_iid": 3027160034,
"price": 499,
"orginal_price": 499,
"promotion_price": 499,
"pic_url": "https://si.geilicdn.com/weidianw631187-25060000016dd7a92e0c0a20e432_960_960.jpg",
"sales": 36,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3027160034"
},
{
"title": "【1120上新纯正外贸订单ydxz1】男女同款!镇店王炸款!蒙口羽绒服,陈奕迅同款,MAYA经典收腰,出入专g无压力🍐",
"num_iid": 3240020511,
"price": 780,
"orginal_price": 780,
"promotion_price": 780,
"pic_url": "https://si.geilicdn.com/weidian1455461168-73760000016f70ab3ea60a20b7b9_1080_1440.jpg",
"sales": 358,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=3240020511"
},
{
"title": "207738.CHLO*家秋冬保暖羊毛小皮草外套\n",
"num_iid": 4248997756,
"price": 750,
"orginal_price": 750,
"promotion_price": 750,
"pic_url": "https://si.geilicdn.com/wdseller901353083325-4f4f000001766f6b17300a20b7b9-unadjust_1124_1500.jpeg",
"sales": 1,
"seller_id": "",
"seller_nick": "",
"detail_url": "https://weidian.com/item.html?itemID=4248997756"
},
{
"title": "【现货】秋冬新款🔥🔥,小香风立领水钻双排扣羊气粗花呢外套,温和的日黄色中和了霸气味道,颜色超级显白,高雅气质S~L",
"num_iid": 4090245934,
"price": 390,
"orginal_price": 390,
"promotion_price": 390,
异常示例
{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "taobao",
"request_id": "15ee0ffc041242"}
错误码解释
状态代码(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 | 未知错误 | 否 |
- 商品列表API接口:
- 主要功能:根据关键词搜索返回商品列表数据。商家可以通过此接口获取符合特定条件的商品列表,用于展示在自家平台或进行数据分析。
- 商品详情API接口:
- 主要功能:通过商品ID或链接获取商品详细信息,如商品名称、介绍、图片等。这有助于商家提供更全面的商品信息给用户,提升购买体验。
- 店铺所有商品数据API接口:
- 主要功能:允许开发者获取微店店铺的所有商品数据,包括商品名称、价格、介绍、图片等。这有助于商家进行供应链管理、竞品分析以及与其他电商平台的数据共享和整合。
- 库存管理API接口:
- 主要功能:实时更新商品库存数量,避免超卖情况的发生。商家在销售商品时,可以通过此接口实时调整库存状态。
- 订单管理API接口:
- 主要功能:包括生成订单、查询订单状态、取消订单等操作。商家可以通过此接口处理用户的订单请求,并获取订单相关的详细信息。
- 支付管理API接口:
- 主要功能:与支付系统对接,实现支付功能。商家可以通过此接口发送支付请求给支付系统,并获取支付结果信息,确保交易的安全和顺畅。
- 物流管理API接口:
- 主要功能:实现物流信息的查询和更新。商家可以将订单的物流信息上传到电商平台,或者通过此接口获取物流信息并展示给用户,提升用户的购物体验。
- 用户管理API接口:
- 主要功能:进行用户信息的查询和管理,包括用户注册、登录、信息更新等操作。这有助于商家更好地了解用户需求,提供个性化的服务。
这些API接口共同构成了微店micro的电商API体系,为商家提供了强大的数据交互和功能调用能力,有助于商家提升运营效率,优化用户体验,实现更好的商业效益。同时,随着电商行业的不断发展,微店micro的电商API也在不断更新和完善,以适应市场的变化和商家的需求。