淘宝客渠道信息备案api接口-渠道推广专属
10506人使用

通过渠道邀请码生成唯一渠道ID,渠道关系ID(即relation_id)的定义:指对合作方对应渠道的唯一标识码,一个渠道方在不同的合作方下会生成不同的渠道关系ID,作为其在该合作方下进行推广效果的识别。

特别注意:此接口提示账号授权已过期,是用户的access_token过期,需要用户重新授权获取access_token

接口地址: http://api.tbk.dingdanxia.com/tbk/publisher_save 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

inviter_code

String

渠道备案 - 淘宝客邀请渠道的邀请码

info_type

Number

类型,必选 默认为1

relation_from

String

渠道备案 - 来源,取链接的来源

offline_scene

String

渠道备案 - 线下场景信息,1 - 门店,2- 学校,3 - 工厂,4 - 其他

online_scene

String

渠道备案 - 线上场景信息,1 - 微信群,2- QQ群,3 - 其他

note

String

媒体渠道备注

register_info

String

{"phoneNumber":"18801088599","city":"江苏省","province":"南京市","location":"玄武区花园小区","detailAddress":"5号楼3单元101室","shopType":"社区店","shopName":"全家便利店","shopCertifyType":"营业执照","certifyNumber":"111100299001"}

线下备案注册信息,字段包含: 电话号码(phoneNumber,必填),省(province,必填),市(city,必填),区县街道(location,必填),详细地址(detailAddress,必填),经营类型(career,线下个人必填),店铺类型(shopType,线下店铺必填),店铺名称(shopName,线下店铺必填),店铺证书类型(shopCertifyType,线下店铺选填),店铺证书编号(certifyNumber,线下店铺选填)

app_key

String

您申请通过具有淘宝客-工具-渠道推广专属权限的应用Appkey

app_secret

String

您申请通过具有淘宝客-工具-渠道推广专属权限的应用Appsecret

access_token

String

用户在您的淘宝应用权限授权后所获得的用户session,文档:https://open.taobao.com/doc.htm?docId=102635&docType=1

返回参数说明

标记

类型

例子

说明

relation_id

Number

123456

渠道关系ID

account_name

String

小明**哈哈

渠道昵称

special_id

Number

12345678

会员运营ID

desc

String

绑定成功

如果重复绑定会提示:”重复绑定渠道“或”重复绑定粉丝“

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "account_name": "为**现",
        "desc": "绑定成功",
        "relation_id": 510087482
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。