淘宝客高级API
淘礼金商品生成api接口
需要授权
1887人使用

淘礼金本质上是一种有跟踪结算能力的单品红包,由淘宝客推广者出资,充值,绑定单品后生成“淘礼金”红包领取中间页链接。在符合相应推广标准的情况下,淘礼金的结算优先级最高。

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

item_id

Number

123456789

宝贝id

total_num

Number

10

淘礼金总个数

name

String

淘礼金来啦

淘礼金名称,最大10个字符

user_total_win_num_limit

Number

1

单用户累计中奖次数上限

security_switch

Boolean

true

启动安全:true;不启用安全:false

per_face

String

10

单个淘礼金面额,支持两位小数,单位元

send_start_time

Date

2020-05-25 00:00:00

发放开始时间

send_end_time

Date

2020-05-26 00:00:00

发放截止时间

use_end_time

String

5

使用结束日期。如果是结束时间模式为相对时间,时间格式为1-7直接的整数, 例如,1(相对领取时间1天); 如果是绝对时间,格式为yyyy-MM-dd,例如,2019-01-29,表示到2019-01-29 23:59:59结束

use_end_time_mode

Number

1

结束日期的模式,1:相对时间,2:绝对时间

use_start_time

String

2019-01-29

使用开始日期。相对时间,无需填写,以用户领取时间作为使用开始时间。绝对时间,格式 yyyy-MM-dd,例如,2019-01-29,表示从2019-01-29 00:00:00 开始

campaign_type

String

DX

CPS佣金计划类型,定向:DX;鹊桥:LINK_EVENT;营销:MKT

app_key

String

请填写您申请的具有淘礼金应用权限的Appkey 申请地址https://survey.taobao.com/apps/zhiliao/BQ2RPRlpU

app_secret

String

请填写您申请的具有淘礼金应用权限的Appsecret

tpwd

Boolean

true: 生成 默认 flase

pid

String

不传默认走后台设置的

shorturl

Boolean

true

是否生成短链接

返回参数说明

标记

类型

例子

说明

rights_id

String

ngNeWFCXF5ixhqX8ej3TS6J7%2BkHL3AEW

淘礼金ID

send_url

String

淘礼金领取Url

tpwd

String

淘口令

shorturl

String

短链接

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "rights_id":"djtlUnQdmsPzo6e1O4NteiMMIHEJMzAA",
        "send_url":"https://uland.taobao.com/taolijin/edetail?eh=ktJkblm%2FZGmZuQF0XRz0iAXoB%2BDaBK5LQS0Flu%2FfbSp4QsdWMikAalrisGmre1Id0BFAqRODu11jZ84%2BJFgXGFxZg1n7BRAH3WUGSw%2FArdZGRD%2B80RfNZEoV5WW2LnvmOjMcUxCSUptG02JPWu4BgGUJTj7Z9tP%2B6OBMXA6gexFmBr9hsMVTDgZABK20chGpa1mmlFscEzpMGagbVbgIpXGGy%2FlBivWt9lhznggCOPG88LRmbQWiWQa0ky7%2Faa1WMXsYMYlwORA%2Fb7MkfTlJ9mwyb%2BDvYvHdCT%2FA9foJQi0lM1ZJHcLCJg%3D%3D&union_lens=lensId%3A0b8dccea_25b3_1724a7f0cd4_6f24%3Btraffic_flag%3Dlm",
        "vegas_code":"8PZ2X56I",
        "tpwd":"¥xs7d0dsX¥"
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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