接口使用场景等说明:本接口是用于把您的用户创建成为您的渠道ID(即备案)。适用于有独立APP等方便授权场景,可用API自动备案。
【备案流程】
假如用户张三在使用您的应用(假如张三的淘宝号是AA),现在要让他通过授权后,在您的应用上创建他的淘宝号对应的渠道ID。
1、张三登录您的应用(APP/网站/公众号等),检测该用户未备案,就提示他要授权后才能领券返现。
2、张三点开始授权,跳转到淘宝(APP上可通过百川SDK,获得免输入帐密)
3、张三用他的淘宝帐号同意授权(H5授权),并跳到授权回调页,此时您的应用将通过授权回调页url,收到授权码sessionkey和userid等参数。(APP上请用webview)
4、在授权回调页,通过调用本接口,取得张三在您的联盟号下的渠道ID。
5、保存渠道ID,并在回调页提示张三授权备案成功,并跳回到购物详情页。
【微信上如何备案】
如查您是微信公众号,推荐使用手动备案方式,参考 http://www.veapi.cn/apidoc/taobaolianmeng/155
【百川SDK授权说明】
1. APP上请用百川SDK调用,百川唤起淘宝APP后实现免帐密,再用webview中进行H5授权。百川具体参考 https://baichuan.taobao.com/ 。
2. 在您开发中,请不要使用在维易中心授权的那个联盟号授权测试,请另备一个联盟小号,当成用户测试。否则您在维易授权中心的授权将因重复授权而失效。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/tbk/publishersave | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
accesstoken | String | 是 | 70022326533... | 要备案的淘宝号授权给维易后得到的token值。授权方法请参考授权指南 |
inviter_code | String | 是 | C2C6ES | 淘宝客邀请渠道的邀请码。使用淘宝客邀请码接口生成或到你的联盟后台手动复制。多用户会员卡只需传递不同的联盟号的邀请码即可。 |
relation_from | String | 否 | 渠道备案来源,取链接的来源。 | |
offline_scene | Number | 否 | 1(默认) | 渠道备案 - 线下场景信息:1 - 门店,2- 学校,3 - 工厂,4 - 其他 |
online_scene | Number | 否 | 1(默认) | 线上场景信息:1 - 微信群,2- QQ群,3 - 其他 |
info_type | Number | 否 | 1(默认) | 渠道类型, |
register_info | String | 否 | {"phoneNumber":"18801088599","city":"江苏省","province":"南京市","location":"玄武区花园小区","detailAddress":"5号楼3单元101室","shopType":"社区店","shopName":"全家便利店","shopCertifyType":"营业执照","certifyNumber":"111100299001"} | (是否需要本参数,取决于备案类型)当你的邀请码备案是用“线下门店”和“线下个人”,请提供本参数,否则会提“省(province)为空 ”等错误,推荐使用“通用备案”。参考这里 |
note | String | 否 | 媒体侧渠道备注信息。一般不要使用本参数,很容易出现“备注信息包含非法”而出现接口调用失败。 | |
account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id,联盟号ID请到会员中心授权页查看 |
GET/POST http://api.veapi.cn/tbk/publishersave?vekey=xxx&inviter_code=邀请码&accesstoken=70025661223332.....
$api="http://api.veapi.cn/tbk/publishersave?vekey=xxx&inviter_code=邀请码&accesstoken=70025661223332....."; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值
import cn.hutool.http.HttpResponse; import cn.hutool.http.HttpRequest; public class testGetParam { public static void main(String[] args) { // API网址 String url = "http://api.veapi.cn/tbk/publishersave?vekey=xxx&inviter_code=邀请码&accesstoken=70025661223332....."; // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权 //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", ""); // 发送请求 String result = HttpRequest.get(url) .timeout(10000)//设置超时,毫秒 .execute().body(); System.out.println(result); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/tbk/publishersave?vekey=xxx&inviter_code=邀请码&accesstoken=70025661223332....." # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
relation_id | Number | 40232 | 渠道关系ID |
account_name | String | xxx | 渠道昵称 |
special_id | Number | 32304 | 会员运营ID |
desc | String | 绑定成功 | 如果重复绑定会提示:”重复绑定渠道“或”重复绑定粉丝“ |
{ "error": "0", "msg": "淘宝客渠道信息备案成功!", "data":{ "relation_id":40232, "account_name":"xxx", "special_id":32304, "desc":"绑定成功" } }