“淘宝邻家好货属于店铺联盟的卖家,在自己手机淘宝店铺商品详情页面的相关位置(页面最下端的“邻家好货”推荐模块)为其他卖家提供推广的同时亦可以获得在同等级别其他卖家的淘宝店铺精准推广的机会。”
对于新接口我们也有所突破----- 前往测试新接口
为了进行电商平台 的API开发,首先我们需要做下面几件事情。
1)开发者注册一个账号
2)然后为每个 应用注册一个应用程序键(App Key) 。
3)下载 API的SDK并掌握基本的API基础知识和调用
4)利用SDK接口和对象,传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。
5)利用平台的文档中心和API测试工具,对接口进行测试。从而了解返回信息,方便程序获取。
以上是一般 API应用开发的关键流程,其中通过文档中心和API测试工具,进行概念了解和接口信息查询很重要。因为这些数据就是我们需要在逐步显示出来的。的API很多,不过都分为了好几个领域,慢慢就会了解深入了。
公共参数
请求地址: https://api-gw.onebound.cn/taobao/item_search_neighbors
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:num_iid=637798472116&seller_id=1091714097
参数说明:num_iid:商品ID
seller_id:卖家ID
不是每个商品都会返回邻家好货推荐
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | item[] | 0 | 邻家好货 | |
title | String | 0 | 丝绒棒球服 ,实用收纳。 拉链短外套 | 宝贝标题 |
pic_url | String | 0 | //img.alicdn.com/bao/uploaded/i1/79444698/TB2Cepidf5TBuNjSspcXXbnGFXa_!!79444698.jpg | 宝贝图片 |
price | Float | 0 | 299 | 价格 |
min_num | int | 0 | 1 | 销量 |
num_iid | Bigint | 0 | 565838198470 | 宝贝ID |
tmall | String | 0 | false | 判断是否天猫 |
detail_url | String | 0 | https://item.taobao.com/item.htm?id=565838198470 | 商品链接 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/taobao/item_search_neighbors/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=637798472116&seller_id=1091714097"
响应示例
{
"item": [
{
"num_iid": 565838198470,
"price": 299,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/79444698/TB2Cepidf5TBuNjSspcXXbnGFXa_!!79444698.jpg",
"title": "丝绒棒球服 ,实用收纳。 拉链短外套",
"sales": 1,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=565838198470"
},
{
"num_iid": 42489760538,
"price": 170,
"pic_url": "//img.alicdn.com/bao/uploaded/i4/TB1cxmXGpXXXXc3XVXXXXXXXXXX_!!0-item_pic.jpg",
"title": "降E中音萨克斯 箱包 箱子 随行箱 包 背包 便携包 盒子硬包双肩背",
"sales": 11,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=42489760538"
},
{
"num_iid": 546919592592,
"price": 98,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/2175450236/O1CN01vhmYzb1Dc8EL5Y6fE_!!2175450236.jpg",
"title": "汽车摆件车内饰用品高档香水座弥勒佛男女士创意车载座式佛像高端",
"sales": 10,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=546919592592"
},
{
"num_iid": 3080762351,
"price": 35,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/19833024751417871/T10XFEFnpcXXXXXXXX_!!0-item_pic.jpg",
"title": "乐仔蒲公英泡泡水250ML与喇叭泡泡管 玉米糖浆吹泡泡液 早教玩具",
"sales": 44,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=3080762351"
},
{
"num_iid": 36051702918,
"price": 228,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/TB16b95JXXXXXbPapXXXXXXXXXX_!!0-item_pic.jpg",
"title": "德国设计 高端防滑汽车收纳箱 折叠车用后备箱 车载整理箱 储物箱",
"sales": 137,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=36051702918"
},
{
"num_iid": 569426237574,
"price": 35,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/861420607/TB22MAtqN9YBuNjy0FfXXXIsVXa_!!861420607.jpg",
"title": "六一儿童新品手工DIY制作粘贴首饰盒卡通kitty收纳盒女孩玩具礼物",
"sales": 18,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=569426237574"
},
{
"num_iid": 526280395803,
"price": 117,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/2564709156/TB25l0HcC0mpuFjSZPiXXbssVXa_!!2564709156.jpg",
"title": "森田高档欧式红外线瓦斯充气炉燃气不锈钢小火锅商用自助火锅配盖",
"sales": 1,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=526280395803"
},
{
"num_iid": 559147703285,
"price": 3888,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/178364283/TB28urua2NNTKJjSspcXXb4KVXa_!!178364283.jpg",
"title": "红木家具鸡翅木茶桌椅组合1.68到2米茶台实木新中式功夫茶桌茶几",
"sales": 13,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=559147703285"
},
{
"num_iid": 563057658042,
"price": 278,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/240823272/TB2uODBjwLD8KJjSszeXXaGRpXa_!!240823272.jpg",
"title": "欧洲站2022春夏新款圆头内增高小白鞋女单鞋厚底运动休闲透气网鞋",
"sales": 39,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=563057658042"
},
{
"num_iid": 564117864550,
"price": 295,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/616625475/TB2RgTzd7fb_uJkSmLyXXcxoXXa_!!616625475.jpg",
"title": "mlb棒球帽男女全黑色春夏ny鸭舌帽硬顶可调节休闲百搭经典la帽子",
"sales": 7,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=564117864550"
},
{
"num_iid": 541396198719,
"price": 66,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/1505303/TB2tKfCcf6H8KJjSspmXXb2WXXa_!!1505303.jpg",
"title": "精品秋冬加绒加厚条绒男童衬衫中大儿童纯棉灯芯绒衬衣上衣过年衣",
"sales": 0,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=541396198719"
},
{
"num_iid": 39529631083,
"price": 75,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/TB1muhhFFXXXXX_bpXXXXXXXXXX_!!0-item_pic.jpg",
"title": "嗓宝 SD-666T教学扩音器腰挂大功率教师导游小蜜蜂唱戏机 插卡U盘",
"sales": 5,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=39529631083"
},
{
"num_iid": 13951392457,
"price": 37,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/95200406/TB2S4b.bHYI8KJjy0FaXXbAiVXa_!!95200406.jpg",
"title": "芝竹堂盐袋子粗盐热敷包家用腰部热敷袋理疗袋海盐艾草灸微波盐包",
"sales": 99,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=13951392457"
},
{
"num_iid": 44333840340,
"price": 310,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/1901206867/TB2ngxJgXXXXXaDXXXXXXXXXXXX_!!1901206867.jpg",
"title": "泰国原装进口熟榴莲肉无核榴莲速冻榴莲肉3公斤金枕头非D24猫山王",
"sales": 8,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=44333840340"
},
{
"num_iid": 562576612813,
"price": 29,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/650641826/TB29reOhYYI8KJjy0FaXXbAiVXa_!!650641826.jpg",
"title": "大富翁游戏棋银牌铜牌世界中国台湾之旅上海滩强手棋娱乐桌游包邮",
"sales": 4,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=562576612813"
},
{
"num_iid": 553785471424,
"price": 56,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/705717539/TB28Bs4x5RnpuFjSZFCXXX2DXXa_!!705717539.jpg",
"title": "温胆汤泡脚包 千年古方湿气拜拜 10小包 罗大伦力荐",
"sales": 33,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=553785471424"
},
{
"num_iid": 17362617240,
"price": 27,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/11211020902894265/T1pXdTXyJbXXXXXXXX_!!0-item_pic.jpg",
"title": "真味兴无锡特产美食 马兰头 马兰拌香干 马兰菜 凉菜真空冰鲜顺丰",
"sales": 22,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=17362617240"
},
{
"num_iid": 555921467052,
"price": 58,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/765984457/TB2g.9PckUkyKJjy1zjXXX1wFXa_!!765984457.jpg",
"title": "跳跳马加大加厚小孩骑马平衡弹跳小马儿童充气橡胶玩具动物跳跳虎",
"sales": 294,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=555921467052"
},
{
"num_iid": 538682586516,
"price": 68.8,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/1661448082/TB2uRoHXr2B11BjSsplXXcMDVXa_!!1661448082.jpg",
"title": "新款定做水晶办公摆件笔筒商务礼品桌面红旗党旗 水晶名片盒",
"sales": 1,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=538682586516"
},
{
"num_iid": 529375024987,
"price": 36.26,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/17379926170/TB2DrmclhxmpuFjSZFNXXXrRXXa_!!17379926170.jpg",
"title": "大号室内迷你乒乓球桌游戏折叠乒乓球台亲子桌面游戏娱乐竞技乒乓",
"sales": 76,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=529375024987"
},
{
"num_iid": 520569793066,
"price": 88,
"pic_url": "//img.alicdn.com/bao/uploaded/i3/TB1_ZRIHFXXXXXgXpXXXXXXXXXX_!!0-item_pic.jpg",
"title": "八骏图十字绣2021新款线绣客厅大幅风景马到成功八匹马自己绣手工",
"sales": 23,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=520569793066"
},
{
"num_iid": 558759901800,
"price": 168,
"pic_url": "//img.alicdn.com/bao/uploaded/i2/712378249/TB28oWBhC3PL1JjSZFxXXcBBVXa_!!712378249.jpg",
"title": "日本矫正坐姿护腰坐垫办公室久坐神器孕妇尾椎骨减压防驼背美臀垫",
"sales": 6,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=558759901800"
},
{
"num_iid": 551023888765,
"price": 30,
"pic_url": "//img.alicdn.com/bao/uploaded/i1/2860104054/TB2aRV7p3xlpuFjy0FoXXa.lXXa_!!2860104054.jpg",
"title": "加强u型单上衣产后收腹衣束腰产后收腹塑身衣微商恋柏尚俏姿同款",
"sales": 13,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=551023888765"
},
{
"num_iid": 540379908688,
"price": 85,
"pic_url": "//img.alicdn.com/bao/uploaded/i4/549233079/TB2rpfxX9OI.eBjy1zkXXadxFXa_!!549233079.jpg",
"title": "泰国实木纸巾筒家居酒店卫生间卷纸筒厕所纸巾架 浴室厨房抽纸盒",
"sales": 18,
"tmall": "false",
"detail_url": "https://item.taobao.com/item.htm?id=540379908688"
}
],
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:51 max:5000 all[72=51+16+5];expires:2023-04-25",
"execution_time": "0.583",
"server_time": "Beijing/2022-07-22 15:44:54",
"client_ip": "106.6.33.140",
"call_args": [],
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "baidu_api",
"server_memory": "4.58MB",
"request_id": "gw-3.62da557602103",
"last_id": "1094121365"
}
异常示例
{
"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": "4ee0ffc041242"
}
相关资料
错误码解释
状态代码(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 | 未知错误 | 否 |