淘礼金创建api接口|淘礼金生成接口|淘礼金接口|淘礼金怎么用|订单侠开放平台

淘礼金商品生成api接口

需要授权

510人使用

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

是

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

item_id

String

是

123456789

宝贝id

total_num

Number

是

淘礼金总个数

name

String

是

淘礼金来啦

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

user_total_win_num_limit

Number

是

单用户累计中奖次数上限

security_switch

Boolean

是

true

启动安全：true；不启用安全：false

per_face

String

是

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

send_start_time

Date

是

2020-05-25 00:00:00

发放开始时间

send_end_time

Date

是

2020-05-26 00:00:00

发放截止时间

use_end_time

String

否

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

use_end_time_mode

Number

否

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

use_start_time

String

否

2019-01-29

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

campaign_type

String

否

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

是否生成短链接

use_threshold

String

否

淘礼金使用门槛，实付款大于等于门槛面额时才可使用此淘礼金；门槛值不能小于淘礼金面额

标记

类型

例子

说明

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

系统异常

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

4017

请求拒绝

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

首页

关于

联系我们