接口地址:
http://api.web.ecapi.cn/taoke/create_taolijin
接口实例:
http://api.web.ecapi.cn/taoke/create_taolijin?apkey=登录会员中心查看&tbappkey=xxxxx&tbappsecret=xxxxx&adzoneid=妈妈广告位Id,PID第三段&itemid=568706761354&end_time=2018-09-01 23:59:59&start_time=2018-08-01 23:59:59&num=100&name=喵有券福利&win_limit=1&secure=true&money=10
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
使用说明:
用于创建淘礼金,需使用自己的Appkey、Appsecret及与Appkey对应应用下的推广位ID,本平台不存储用户敏感信息及生成的淘礼金信息,请悉知
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
tbappkey | String | xxxxx | 是 | 有淘礼金权限的Appkey,不知道有没有的登录:open.taobao.com,进行查看 |
tbappsecret | String | xxxxx | 是 | 有淘礼金权限的Appkey对应的Appsecret,不知道有没有的登录:open.taobao.com,进行查看 |
adzoneid | String | 妈妈广告位Id,PID第三段 | 是 | |
itemid | String | 568706761354 | 是 | 宝贝id |
end_time | String | 2018-09-01 23:59:59 | 是 | 发放结束时间 |
start_time | String | 2018-08-01 23:59:59 | 是 | 发放开始时间 |
num | String | 100 | 是 | 淘礼金总个数 |
name | String | 喵有券福利 | 是 | 淘礼金名称,最小5个字符,最大10个字符 |
win_limit | Number | 1 | 是 | 单用户累计中奖次数上限 |
secure | String | true | 是 | 安全开关,启动安全:true;不启用安全:false |
money | String | 10 | 是 | 单个淘礼金面额,单位元 |
jihua_type | String | | | CPS佣金计划类型,定向:DX;鹊桥:LINK_EVENT;营销:MKT |
-
返回参数
-
返回参数 | 类型 | 参数说明 | 扩展说明 |
data | Json | 创建成功后返回数据 | |
├ rights_id | String | 淘礼金ID | |
├ send_url | String | 淘礼金领取URL | |
-
Json返回示例
-
{"code":200,"data":{"rights_id":"KxdUxExxxxxxxxxO4s01aw==","send_url":"https://uland.taobao.com/taolijin/edetail?eh=6s7owKBy%xxxxxxxxxx3Dlm"},"msg":"数据获取成功."}
-
code/http_status说明
-
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |