当前位置：网站首页>全新接口——邻家好货 API
全新接口——邻家好货 API
2022-08-10 16:48:00 【分享干货的猫】
“淘宝邻家好货属于店铺联盟的卖家,在自己手机淘宝店铺商品详情页面的相关位置(页面最下端的“邻家好货”推荐模块)为其他卖家提供推广的同时亦可以获得在同等级别其他卖家的淘宝店铺精准推广的机会。”
对于新接口我们也有所突破----- 前往测试新接口
为了进行电商平台 的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 | 未知错误 | 否 |
边栏推荐
猜你喜欢
随机推荐
山西：一煤矿发生死亡1人安全事故 被责令停产整顿
leetcode：339 嵌套列表权重和
让页面滚动到指定位置
网易云信亮相LiveVideoStackCon2022，解构基于WebRTC的开源低延时播放器实践
Basic knowledge of software engineering--requirements analysis
v-bind指令：设置元素的属性
FTXUI基础笔记（hello world）
＃夏日挑战赛＃【ELT.ZIP】啃论文俱乐部——学术科研方法论沉淀辑
v-model指令：获取和设置表单元素的值
等保2.0一个中心三重防护指的是什么？如何理解？
v-for指令：根据数据生成列表结构
观测云入选 CNCF 云原生全景图
易基因｜深度综述：m6A RNA甲基化在大脑发育和疾病中的表观转录调控作用
requests库访问接口
C专家编程 第10章 再论指针 10.7 使用指针创建和使用动态数组
C专家编程 第10章 再论指针 10.8 轻松一下---程序检验的限制
重庆新壹汽与一汽集团达成新能源项目战略合作，赋能“碳中和”创造“碳财富”
glut库更新旧程序无法完成编译问题描述
【无标题】
在 Istio 服务网格内连接外部 MySQL 数据库