淘宝客高级API
官方活动转链,饿了么/口碑活动转链
需要授权
1989人使用

支持通过推广位和活动物料id获取活动详情,包含推广url(长链、短链)、微信推广二维码地址等。

官方活动地址:https://pub.alimama.com/fourth/promo/activity.htm

饿了么订单接口文档:https://www.dingdanxia.com/doc/60/8

淘宝联盟将于2023年3月16日0点起下架饿了么相关活动,如需继续推广饿了么活动可在聚推客联盟继续推广

详细说明:https://www.jutuike.com/article/1121.html

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

activity_material_id

String

20150318019998877

官方的物料id

relation_id

String

渠道id,不可自定义,需用户备案授权获取

pid

String

推广位,不传默认走后台默认的

tpwd

Boolean

true

默认不生成口令(注意:如果传了tpwd口令没出来,说明该链接可能不支持生成口令)

tb_auth_id

String

多授权,切换授权参数

返回参数说明

标记

类型

例子

说明

click_url

String

推广长链

wx_qrcode_url

String

微信小程序推广二维码地址(该小程序码的有效期为300天),该二维码仅在饿了么活动才返回

short_click_url

String

短连接

terminal_type

String

投放平台, 1-PC 2-无线

material_oss_url

String

物料素材下载地址

page_name

String

会场名称

page_start_time

String

活动开始时间

page_end_time

String

活动结束时间

wx_miniprogram_path

String

微信小程序推广路径

tpwd

String

淘口令

long_tpwd

String

淘口令 长淘口令 兼容 ios 14,推荐使用

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"click_url": "https://s.click.ele.me/t?union_lens=lensId%3AMAPI%401611216912%402107ee3f_0a40_1772403005e_21ea%4001%3BeventPageId%3A20150318019998877&&e=-s02g5MlyUmbrP2Y4y3lJiQ7magwMO1V3P93JNHsLLoQUy7B9dRc1Ae5PpGZROsV5dMPIJUcisPcpHjfPDqKzzTFLWvK5GB72QxTC0dWibeBHp27lqkibOEntQxWBfb3PGqdceumcFTlrAkBxShC1GI0S0aoEaYJbVeJpsLIhUD4LYJmeet4EY42ByVI64bTUUIagIFahI9C3KPSRNi8KzLaz2B0OKNRjmu1JU6TNgz6SPTA0PIyCZnGRrc1aGyeVb6byF7zpGgp3j0TEb464e55tnEMU39gLnDwJNICuZ2tIUwfBycI2Hx6P8mPJFq9KKdlH77kaPeV75Wa3TGM8mw1yp6tLjbESLrEGs3M7jJF2l2eiAbZlZ7qDzsdsnOmNzWxoUnU8SCcBf37E3F4nCdEsxd9Umkq29tIEFzLqA4W0RGOV2pmF4mrWYp3DpmGCDHpJmhoYbAWgMG3stc90H3ULxBqRYSljYF9XyqC&",
		"short_click_url": "https://s.click.ele.me/T50Avru",
		"wx_miniprogram_path": "pages/sharePid/web/index?scene=https://s.click.ele.me/T50Avru",
		"wx_qrcode_url": "https://img.alicdn.com/imgextra/i4/6000000005819/O1CN01TWnD9F1sr9Mbuui5F_!!6000000005819-0-o2oad.jpg",
		"tpwd": "¥rDoacuwVo3q¥",
		"long_tpwd": "1¥rDoacuwVo3q¥䛬 https://m.tb.cn/h.48aVaXv【點击“打开”查看并浏览页面详情,精选商品任您选购】"
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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