京推推首页
您好 ，请登录 免费注册
小工具 商家合作 开放平台API 帮助中心 联系我们
小程序
在线客服
我的收藏
帮助中心
官方采集群 在线客服
我的收藏 管理收藏夹
收起
商品文案 

				

				
			

		

	

	
	





    API基础说明
    系统参数
    请求参数
    返回参数
    返回示例
    
    






    

        API市场>
        基础功能API >礼金创建
    






 
 
礼金创建 （礼金创建接口） 免费
 
API类型: 基础功能API 使用人数:--
 
 槽点建议
 
API接口说明： 礼金创建接口可针对指定商品生成礼金批次ID，之后还需调用转链接口，传入商品链接+礼金ID+普通优惠券链接，即可生成礼金推广链接，进行投放推广。
 
API使用建议： 
                            您需要预先充值才可创建礼金，请在联盟PC官网-工具场景-京享礼金，或京粉app-首页京享礼金内进行充值。（您需开通礼金充值权限方可充值，部分在黑名单中的商品不可创建礼金）                        
 
应用场景： 
 
 应用效果  免费接入  接口测试
 
槽点建议 
 
  
 
 
 
 
 
 
 上传图片
                                 
 
 
提交
 
 
 
 
 
 
API接口明细 API更新记录 错误参照代码
 

                            版本号：v1
                        
 
接口地址: http://japi.jingtuitui.com/api/creat_coupon_gift
 
请求数据: http://japi.jingtuitui.com/api/creat_coupon_gift?appid=&appkey=&jd_key=&jd_secretkey=&sku=&discount=&amount=&receive_start_time=&receive_end_time=&is_spu=&expire_type=&effective_days=&share=
 
请求方式: GET / POST
 
支持格式: json / jsonp
 
系统参数 
 
名称 类型 必填 示例 说明
 
appid 
 复制
 Int 是 2010091553028980 您在京推推申请的appid
appkey 
 复制
 String 是 2 您在京推推申请的appkey
v 
 复制
 String 是 v1 API接口版本号，当前版本: v1
return_type 
 复制
 String 否 code_jsonp 返回数据格式，不传参默认json,支持以下参数code、jsonp、code_jsonp
 
请求参数说明 
 
名称 类型 必填 示例 说明
 
jd_key 
 复制
 String 
                                                是 
                                                     
                                                京东联盟分配给应用的appkey，可在京东联盟应用查看中获取appkey
jd_secretkey 
 复制
 String 
                                                是 
                                                     
                                                京东联盟分配给应用的secretkey，可在京东联盟应用查看中获取appkey
sku 
 复制
 String 
                                                是 
                                                    11144230或者https://item.jd.com/11144230.html 
                                                商品skuId或落地页地址、联盟商品ID或联盟商品链接
discount 
 复制
 Number 
                                                是 
                                                    1 
                                                优惠券面额，最小不可低于1元，最大不可超过pop商品价格的80%，自营商品价格的50%。如：1或者1.00或者1.01
amount 
 复制
 Number 
                                                是 
                                                    20 
                                                总数量
receive_start_time 
 复制
 String 
                                                是 
                                                    2019-10-18 00 
                                                领取开始时间(yyyy-MM-dd HH)，区间为(创建当天0点直至未来6天内)，系统补充为yyyy-MM-dd HH:00:00
receive_end_time 
 复制
 String 
                                                是 
                                                    2019-10-18 23 
                                                领取结束时间(yyyy-MM-dd HH)，区间为(创建当前时间点直至未来6天内)，系统补充为yyyy-MM-dd HH:59:59
is_spu 
 复制
 Number 
                                                是 
                                                    1 
                                                是否绑定同spu商品(1:是;0:否)，例如skuMaterialId输入一款37码的鞋，当isSpu选择1时，此款鞋的全部尺码均可推广这张礼金；当isSpu选择0时，此款鞋仅37码可推广这张礼金，其他鞋码不支持
expire_type 
 复制
 Number 
                                                是 
                                                    1 
                                                使用时间类型：1.相对时间，需配合effectiveDays一同传入；2.绝对时间，需配合useStartTime和useEndTime一同传入
share 
 复制
 Number 
                                                是 
                                                    1 
                                                每个礼金推广链接是否限制仅可领取1张礼金：-1不限，1限制
effective_days 
 复制
 Number 
                                                否 
                                                    1 
                                                消费者领取后n天内可用，时间天数1至7，当expireType=1时，必须设置该字段
use_start_time 
 复制
 String 
                                                否 
                                                    2019-11-18 
                                                消费者领取后的使用开始时间，格式：yyyy-MM-dd，系统补充为yyyy-MM-dd HH:00:00，当expireType=2时，必须设置该字段
use_end_time 
 复制
 String 
                                                否 
                                                    2019-11-18 
                                                消费者领取后的使用结束时间，格式：yyyy-MM-dd，系统补充为yyyy-MM-dd HH:59:59，当expireType=2时，必须设置该字段
content_match 
 复制
 Number 
                                                否 
                                                    0 
                                                是否允许通过内容平台推广，0：不允许，1：允许；默认为0
coupon_title 
 复制
 String 
                                                否 
                                                    礼金2020 
                                                礼金名称
content_match_medias 
 复制
 String 
                                                否 
                                                    17,18,21 
                                                contentMatch = 1 时此字段方生效，允许推广的媒体类型 -1：全部， 其他枚举值：17: 抖音,18: 快手,21: 微博,22: 知乎, 35: 斗鱼 ,38 : 手机QQ/全民K歌,43: 百家号图文,49: 微信小商店/腾讯微视，-1与其他枚举值互斥
show_in_medias 
 复制
 Number 
                                                否 
                                                    0 
                                                是否仅在所选平台访问链接时展示礼金，0:否 1:是
target_type 
 复制
 Number 
                                                否 
                                                    6 
                                                定向推广类型，默认为1，向运营申请定向功能后才能入参4,5,6并生效； 1.不定向推广 4:本账号推广-定向PID 5：合作账号推广-定向联盟ID 6:合作账号推广-定向PID
child_promoters 
 复制
 String 
                                                否 
                                                    [{ 'targetName': '达人A', 'targetValue': '1002132107_4100446224_3003707911' }] 
                                                json格式字符串；targetName为定向的合作方名称，targetValue为联盟ID或PID；定向本账号推广时入参PID，定向合作方推广时入参合作方名称和联盟ID或PID；targetType in (4,5,6) 时必填
 
返回参数说明 
 
名称 类型 示例值 说明
 
return 
 复制
 Int 
                                                0 
                                                0=返回成功
result 
 复制
  
                                                 
                                                返回结果
 
 复制
  
                                                 
                                                
 
JSON返回示例 
 






    {
        "code": "0",
        "result": {
            "giftCouponKey": "4f70ed5a367c94bf"
        },
        "msg": "ok~"
    }
 
 
错误码 说明
 
0 请求成功
 
1000 appid或appkey错误
 
2000 API次数调用超过上限
 
3000 API权限不足







	
		

			

				

					
					
					
				

				
CopyRight © 2015-2022 京推推 www.jingtuitui.com 浙ICP备17019584号