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

taobao.tbk.sc.relation.record (淘宝客-服务商-私域会员标记)

服务商使用。支持淘宝客通过入参私域外部ID,获得待私域会员可标记的链接,会员打开该链接后,可帮助媒体自动生成会员运营id进行标记,同时自动跳转到推广落地页。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
external_id String 必须 100000 淘宝客自有私域用户自定义标记,如自有私域系统账号标记等
external_type Number 必须 1 淘宝客其他平台私域用户自定义标记,1-微信、2-微博、3-抖音、4-快手、5-QQ,0-其他
op_type Number 必须 1 授权类型,选2时可用于更新外部用户标记,默认1:1-新绑,2-更新
redirect_url String 必须 http://www.taobao.com 会员备案授权后,跳转的目标页地址
ucrowd_id Number 可选 1 人群标签ID,用户备案授权后会自动添加到该人群

响应参数

名称 类型 示例值 描述
data MapData data
  • └ url
  • String
  • https://mo.m.taobao.com/union/relation/record
  • 带授权的备案链接
  • └ password_simple
  • String
  • 已废弃,请调用淘口令生成接口
  • └ model
  • String
  • 已废弃,请调用淘口令生成接口

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScRelationRecordRequest req = new TbkScRelationRecordRequest();
req.setExternalId("100000");
req.setExternalType(1L);
req.setOpType(1L);
req.setRedirectUrl("http://www.taobao.com");
req.setUcrowdId(1L);
TbkScRelationRecordResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_sc_relation_record_response>
    <data>
        <url>https://mo.m.taobao.com/union/relation/record</url>
        <password_simple></password_simple>
        <model></model>
    </data>
</tbk_sc_relation_record_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>

错误码解释

错误码 错误描述 解决方案
1501 不支持该跳转url 更改url

API工具

如何获得此API

FAQ

返回
顶部