正常淘客官方活动推广接口在线测试

淘宝客官方活动转链(更新版)

接口地址： http://api.web.ecapi.cn/taoke/getTbkActivityInfo

接口实例： http://api.web.ecapi.cn/taoke/getTbkActivityInfo?apkey=登录会员中心查看&tbname=xxxx&pid=mm_123456_456789_789132&activity_material_id=xxxx&relation_id=xxxx

注意事项：如调用接口时数据返回异常，则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码，然后再试。

请求方式：GET

会员范围：全部会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<- 。

使用说明: 口碑城市生活周：http://pages.tmall.com/wow/alsc/mod/c9e5472d65868f931d350439
活动ID：1583739244161

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
tbname	String	xxxx	是	在本平台授权的淘宝用户名，有中文时需进行Urlencode编码
pid	String	mm_123456_456789_789132	是	淘宝联盟PID（注：如已在会员中心设置了默认PID，此参数可无需再次传入）
activity_material_id	String	xxxx	是	活动ID，支持通过推广位和活动物料id获取活动详情，包含推广url（长链、短链），淘口令、微信推广二维码地址等。淘宝联盟官方活动推广API-工具，支持二方、三方
relation_id	String	xxxx	是	渠道关系id，获取说明：https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639（注：如已在会员中心设置了默认渠道ID，此参数可无需再次传入）
hastpwd	String	1		是否生成淘口令，1为生成，不填或填写其他为不生成，如果生成，则tpwd_title参数必须传入，否则不生效
tpwd_title	String	淘口令标题		与hastpwd配合使用
union_id	String	Vxxxxxxx		自定义输入串，英文和数字组成，长度不能大于12个字符，区分不同的推广渠道

返回参数

返回参数	类型	参数说明	扩展说明
data	Json	返回数据列表
├　click_url	String	活动推广地址
├　tpwd	String	活动推广地址对应的淘口令	此为可选项，详见入参说明
├　wx_qrcode_url	String	微信小程序推广二维码地址	【本地化】微信推广二维码地址
├　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	【本地化】微信小程序推广路径

Json返回示例: {"code":200,"data":{"click_url":"https://s.click.koubei.com/t?&e=-s02yxxxxx01","tpwd":"￥75xxxx0Q￥"},"msg":"success"}

code/http_status说明

code/http_status	说明
200	数据获取成功
-1	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对