文档中心 > API类目 > 淘宝客API

taobao.tbk.sc.publisher.info.save (淘宝客-公用-私域用户备案)

通过入参渠道管理或会员运营管理的邀请码,生成渠道id或会员运营id,完成渠道或会员的备案。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
relation_from String 可选 1 渠道备案 - 来源,取链接的来源
offline_scene String 可选 1 渠道备案 - 线下场景信息,1 - 门店,2- 学校,3 - 工厂,4 - 其他
online_scene String 可选 1 渠道备案 - 线上场景信息,1 - 微信群,2- QQ群,3 - 其他
inviter_code String 必须 xxx 淘宝客邀请渠道或会员的邀请码
info_type Number 必须 1 类型,必选 默认为1:
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,线下店铺选填)

响应参数

名称 类型 示例值 描述
data Data data
  • └ relation_id
  • Number
  • 40232
  • 渠道关系ID
  • └ account_name
  • String
  • xxx
  • 渠道昵称
  • └ special_id
  • Number
  • 32304
  • 会员运营ID
  • └ desc
  • String
  • 绑定成功
  • 如果重复绑定会提示:”重复绑定渠道“或”重复绑定粉丝“

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScPublisherInfoSaveRequest req = new TbkScPublisherInfoSaveRequest();
req.setRelationFrom("1");
req.setOfflineScene("1");
req.setOnlineScene("1");
req.setInviterCode("xxx");
req.setInfoType(1L);
req.setNote("小蜜蜂");
req.setRegisterInfo("{\"phoneNumber\":\"18801088599\",\"city\":\"江苏省\",\"province\":\"南京市\",\"location\":\"玄武区花园小区\",\"detailAddress\":\"5号楼3单元101室\",\"shopType\":\"社区店\",\"shopName\":\"全家便利店\",\"shopCertifyType\":\"营业执照\",\"certifyNumber\":\"111100299001\"}");
TbkScPublisherInfoSaveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_sc_publisher_info_save_response>
    <data>
        <relation_id>40232</relation_id>
        <account_name>xxx</account_name>
        <special_id>32304</special_id>
        <desc>绑定成功</desc>
    </data>
</tbk_sc_publisher_info_save_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.tbkapi-service-unavailable 淘宝客API服务不可用 请稍后重试
isv.invalid-parameter:start_price 参数填写不正确 参数填写不正确
isv.invalid-parameter:end_price 参数填写不正确 参数填写不正确
isv.invalid-parameter:end_tk_rate 参数填写不正确 参数填写不正确
4 查询不到对应的adzoneId 请检查adzoneId是否正确
2 pid不正确 请检查是否输入了正确的adzoneId和siteId
1 内部服务不可用 稍后重试
30501 输入参数info_type非法 参考文档
isp.sys-error 内部服务出错 稍后重试

API工具

如何获得此API

FAQ

返回
顶部