接口地址:
https://www.ecapi.cn/index/extapi/tbkrelationbeian
接口实例:
https://www.ecapi.cn/index/extapi/tbkrelationbeian?apkey=登录会员中心查看&infotype=1&invitercode=
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
使用说明:
渠道商一键备案API
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
将参数拼接到链接上,进行授权登录即可实现渠道商自动绑定,如需获取授权登录链接在淘宝APP内授权登录,可使用此链接:http://www.ecapi.cn/index/extapi/tbkrelationbeian2,参数与本接口一致
-
请求参数
-
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
infotype | Number | 1 | 是 | 1:渠道备案 |
relationfrom | String | | | 渠道备案 - 来源,取链接的来源 |
offlinescene | Number | 4 | | 线下场景信息,1 - 门店,2- 学校,3 - 工厂,4 - 其他 |
onlinescene | Number | 1 | | 线上场景信息,1 - 微信群,2- QQ群,3 - 其他 |
note | String | | | 媒体侧渠道备注 |
invitercode | String | | 是 | 淘宝客邀请渠道的邀请码 |
custompar | String | 123465 | | 自定义输入串,英文和数字组成,长度不能大于20个字符 |
return_url | String | https%3a%2f%2fopen.21ds.cn | | 备案成功后跳转地址,需将网址进行Urlencode编码,带备案返回数据,不填则返回JSON |
oauth_style | String | wap | | 授权登录页面样式,wap为H5版,web为网页版,不填默认为H5版 |
-
返回参数
-
返回参数 | 类型 | 参数说明 | 扩展说明 |
data | Json | 成功结果数据 | |
├ account_name | String | 渠道商用户名 | |
├ relation_id | Number | 渠道ID | |
├ custompar | String | 自定义输入串 | |
code | Number | 200 | 200:表示绑定成功,其他值表示失败 |
-
Json返回示例
-
{"code":200,"data":{"account_name":"启**技","desc":"绑定成功","relation_id":"520000114"},"msg":"淘宝客渠道信息备案成功"}
-
code/http_status说明
-
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |