开放平台免费API不需用户授权,“淘宝客【推广者】任务目标用户判断”共包含一个API
淘宝搜:【天降红包222】领超级红包,京东搜:【天降红包222】
淘宝互助,淘宝双11微信互助群关注公众号 【淘姐妹】
权限包“淘宝客【推广者】任务目标用户判断”共包含一个API
淘宝客-推广者-定向活动目标发布 taobao.tbk.rta.consumer.match
API详细介绍
淘宝客计划向用户推送某个定向活动时,调用该接口判断用户是否符合活动目标(淘宝客接入前需签署协议 https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)
taobao.tbk.rta.consumer.match( 淘宝客-推广者-定向活动目标发布 )
淘客计划向用户推送某个定向活动时,调用该接口判断用户是否符合活动目标(淘客接入前需签署协议 https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)
公共参数
请求地址:
环境 | HTTP地址 | HTTPS地址 |
---|---|---|
正式环境 | http://gw.api.taobao.com/router/rest | https://eco.taobao.com/router/rest |
公共请求参数:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称,例如:taobao.tbk.rta.consumer.match |
app_key | String | 是 | TOP分配给应用的AppKey,例如:12345678 |
session | String | 否 | 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟 |
v | String | 是 | API协议版本,可选值:2.0 |
sign_method | String | 是 | 签名的摘要算法,可选值为:hmac,md5,hmac-sha256。 |
sign | String | 是 | API输入参数签名结果,签名算法介绍请点击这里 |
format | String | 否 | 响应格式。默认为xml格式,可选值:xml,json。 |
simplify | Boolean | 否 | 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false |
公共响应参数:
名称 | 类型 | 描述 |
---|---|---|
request_id | String | 平台颁发的每次请求访问的唯一标识 |
error_response | String | 请求访问失败时返回的根节点 |
code | String | 请求失败返回的错误码 |
msg | String | 请求失败返回的错误信息 |
sub_code | String | 请求失败返回的子错误码 |
sub_msg | String | 请求失败返回的子错误信息 |
***_response | String | 请求成功返回的根节点,'***' 为API名称的下划线模式 |
请求参数
名称
类型
必须
示例值
描述
adzone_id
Number
true
33
mm_xxx_xxx_xxx的第3段数字
offer_list
OfferList[]
true
活动列表
offer_id
String
false
123
活动id
tlj_url
String
false
https://www.taobao.com
淘礼金领取URL,不支持使用短链接
item_id
String
false
1
商品id
special_id
String
false
1
消费者对应的会员ID(会员ID或设备信息同时填时,优先使用会员ID)
device_value
String
false
ssss
设备信息,加密后的值(IMEI,IDFA,OAID,MOBILE需要加密),需用MD5加密,32位小写
device_type
String
false
OAID
设备信息,入参类型(该模式下返回的结果为模糊匹配结果,和实际情况可能存在误差):IMEI, 或者IDFA, 或者OAID, 或者MOBILE, 或者ALIPAY_ID