数据接口API

点击获取APKEY

正常 渠道商一键备案API


请求链接: https://open.21ds.cn/index/extapi/tbkrelationbeian
请求实例: https://open.21ds.cn/index/extapi/tbkrelationbeian?apkey=登录后即可显示&infotype=1&invitercode= (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 渠道商一键备案API
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 >立即抢购<<-

使用说明

将参数拼接到链接上,进行授权登录即可实现渠道商自动绑定,如需获取授权登录链接在淘宝APP内授权登录,可使用此链接:https://open.21ds.cn/index/extapi/tbkrelationbeian2,参数与本接口一致

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 基础设置 中查看APKEY密钥(*必要
infotypeNumber11:渠道备案
relationfromString渠道备案 - 来源,取链接的来源
offlinesceneNumber4线下场景信息,1 - 门店,2- 学校,3 - 工厂,4 - 其他
onlinesceneNumber1线上场景信息,1 - 微信群,2- QQ群,3 - 其他
noteString媒体侧渠道备注
invitercodeString淘宝客邀请渠道的邀请码
customparString123465自定义输入串,英文和数字组成,长度不能大于20个字符
return_urlStringhttps%3a%2f%2fopen.21ds.cn备案成功后跳转地址,需将网址进行Urlencode编码,带备案返回数据,不填则返回JSON
oauth_styleStringwap授权登录页面样式,wap为H5版,web为网页版,不填默认为H5版

返回参数

返回参数类型参数说明扩展说明
dataJson成功结果数据
 ├ account_nameString渠道商用户名
 ├ relation_idNumber渠道ID
 ├ customparString自定义输入串
codeNumber200200:表示绑定成功,其他值表示失败

Json返回示例

{"code":200,"data":{"account_name":"启**技","desc":"绑定成功","relation_id":"520000114"},"msg":"淘宝客渠道信息备案成功"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对