京东礼金创建API接口
1581人使用

礼金创建接口可针对指定商品生成礼金批次ID,之后还需调用转链接口,传入商品链接+礼金ID+普通优惠券链接,即可生成礼金推广链接,进行投放推广。 注:您需要预先充值才可创建礼金,请在联盟PC官网-工具场景-京享礼金,或京粉app-首页京享礼金内进行充值。(您需开通礼金充值权限方可充值,部分在黑名单中的商品不可创建礼金

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

appkey

String

自己京东联盟应用appkey

secretkey

String

自己京东联盟应用secretkey

skuMaterialId

String

11144230或者https://item.jd.com/11144230.html

商品skuId或落地页地址

discount

Double

1或者1.00或者1.01

优惠券面额,最小不可低于1元,最大不可超过pop商品价格的80%,自营商品价格的50%

amount

Integer

11

总数量

receiveStartTime

String

2020-12-23 00

领取开始时间(yyyy-MM-dd HH),区间为(创建当天0点直至未来6天内),系统补充为yyyy-MM-dd HH:00:00

receiveEndTime

String

2020-12-25 00

领取结束时间(yyyy-MM-dd HH),区间为(创建当前时间点直至未来6天内),系统补充为yyyy-MM-dd HH:59:59

effectiveDays

Integer

1

消费者领取后n天内可用,时间天数1至7,当expireType=1时,必须设置该字段

isSpu

Integer

1

是否绑定同spu商品(1:是;0:否),例如skuMaterialId输入一款37码的鞋,当isSpu选择1时,此款鞋的全部尺码均可推广这张礼金;当isSpu选择0时,此款鞋仅37码可推广这张礼金,其他鞋码不支持

expireType

Integer

1

使用时间类型:1.相对时间,需配合effectiveDays一同传入;2.绝对时间,需配合useStartTime和useEndTime一同传入

useStartTime

String

2019-11-18

消费者领取后的使用开始时间,格式:yyyy-MM-dd,系统补充为yyyy-MM-dd HH:00:00,当expireType=2时,必须设置该字段

useEndTime

String

2019-11-18

消费者领取后的使用结束时间,格式:yyyy-MM-dd,系统补充为yyyy-MM-dd HH:59:59,当expireType=2时,必须设置该字段

share

Integer

1

每个礼金推广链接是否限制仅可领取1张礼金:-1不限,1限制

contentMatch

Integer

0

是否允许通过内容平台推广,0:不允许,1:允许;默认为0

couponTitle

String

礼金2020

礼金名称

返回参数说明

标记

类型

例子

说明

giftCouponKey

String

4f70ed5a367c94bf

礼金批次ID,调用转链接口获取推广链接时,传入此参数可获得礼金推广链接

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"giftCouponKey": "4f70ed5a367c94bf"
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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