API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

淘客渠道ID备案(API创建渠道ID)接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

本接口是用于把您的用户创建成为您的渠道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. 在您开发中,请不要使用在维易中心授权的那个联盟号授权测试,请另备一个联盟小号,当成用户测试。否则您在维易授权中心的授权将因重复授权而失效。

调用说明

本接口需要您在会员中心授权(如果多用户可传入sessionkey参数)

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/tbk/publishersave 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
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请到会员中心授权页查看

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/publishersave?vekey=xxx&inviter_code=邀请码&accesstoken=70025661223332..... 

使用curl函数,curl不是php原生库,需要安装才能使用

$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; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

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);
    }
}
推荐使用 requests,支持访问http,https网页:

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

返回值(JSON)

参数名称 参数类型 示例值 描述
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":"绑定成功" } }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部