数据接口API

如何获取APKEY?

正常 淘宝联盟官方活动推广API


请求链接: https://api.open.21ds.cn/apiv2/gettkactivitylink
请求实例: https://api.open.21ds.cn/apiv2/gettkactivitylink?apkey=登录后即可显示&adzoneid=123456&siteid=789465&tbname=xxxxx&activity_id=12345678 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
今日调用统计: 暂无统计
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。
使用说明: 淘宝联盟官方活动推广API
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:阿里云双11来了,亿元补贴提前领,拼团1折起,新老用户同享!【阿里云双11新客上云仅86元/年】活动时间2019年10月24日-11月11日。>立即抢购<<-

使用说明

活动ID获取方式如下:

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 基础设置 中查看APKEY密钥(*必要
adzoneidNumber123456推广位id,mm_xx_xx_xx pid三段式中的第三段
siteidNumber789465推广位id,mm_xx_xx_xx pid三段式中的第二段
tbnameStringxxxxx在本平台授权登录后的淘宝名称
activity_idNumber12345678官方活动ID,从官方活动页获取
union_idString自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道
relation_idNumber渠道关系ID,仅适用于渠道推广场景
platformNumber11:PC,2:无线,默认:1
hastpwdNumber1是否生成淘口令,1为生成,不填或填写其他为不生成,如果生成,则tpwd_title参数必须传入,否则不生效
tpwd_titleString淘口令标题与hastpwd配合使用
tpwd_logoString淘口令弹窗图

返回参数

返回参数类型参数说明扩展说明
dataString淘宝联盟官方活动推广URL淘客链接
tpwdString淘口令不生成时为空

Json返回示例

{"code":200,"data":"https://s.click.taobao.com/t?e=m=2&s=pMTuRypy1WwcQipKwQzePCperVdZeJviyK8Cckff7TVRAdhuF14FMR59pWxVnQAQlovu/CElQOuHB9kPp4/cAd4Lvvh7nsGUtUsENeYeIr8NqxKlb2d+2CWngVphsdEOAFeBK6/tK/sq2x4KkidPL80Q9fK1X0Au0ItOGVs+65m09JAXb5FykI7LAa3DUrM2zt5vEinufIVAFEHVckI7b6KIQf0aX9fe8HvnmX8pALzwdM/Kpa7/owt9G37iDoKPz5NWqJ5LsPcrOtp58OXWEXt41NEyiuTsPQUuEDH+G9Q38RtRv5uQSOeWClVZqtTxWBIX83bU20jYfM2X6bVVepqruKAWV6ij++PAGtLW1YgaYKSqpDJUXZOUfLfsh/pLon3FthgjOGuIaXWks3DBsomlsM5mGFusxHHg2U96HP/p4Ff8nXEyh8YMXU3NNCg/&pvid=25013252","msg":"活动链接获取成功"}

code/http_status说明

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