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

				

				
			

		

	

	
	





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






    

        API市场>
        入库更新API >优惠券信息
    






 
 
优惠券信息 （优惠券链接的详细信息） 免费
 
API类型: 入库更新API 使用人数:3600+
 
 槽点建议
 
API接口说明： 通过领券链接查询优惠券的平台、面额、期限、可用状态、剩余数量等详细信息，通常用于和商品信息一起展示优惠券券信息。v2版本支持多张券集合查询
 
API使用建议： 
                            联盟所有商品均可用此API，建议与【商品基础信息】【优惠券信息】API一起使用                        
 
应用场景： 构建京东商品库，可应用于媒体内京东版块商品瀑布流搭建。
 
 应用效果  免费接入  接口测试
 
槽点建议 
 
  
 
 
 
 
 
 
 上传图片
                                 
 
 
提交
 
 
 
 
 
 
API接口明细 API更新记录 错误参照代码
 

                            版本号：v3（京推推参数统一版本，功能同v2）
                        

                            版本号：v2（即将下线）
                        

                            版本号：v1（即将下线）
                        
 
接口地址: http://japi.jingtuitui.com/api/get_coupom_info
 
请求数据: http://japi.jingtuitui.com/api/get_coupom_info?appid=&appkey=&v=v3&couponUrls=
 
请求方式: GET / POST
 
支持格式: json/jsonp
 
系统参数 
 
名称 类型 必填 示例 说明
 
appid 
 复制
 Int 是 2010091553028980 您在京推推申请的appid
appkey 
 复制
 String 是 2 您在京推推申请的appkey
v 
 复制
 String 是 v3 API接口版本号，当前版本 v3
return_type 
 复制
 String 否 code_jsonp 返回数据格式，不传参默认json,支持以下参数code、jsonp、code_jsonp
 
请求参数说明 
 
名称 类型 必填 示例 说明
 
couponUrls 
 复制
 String 
                                                是 
                                                    https://coupon.m.jd.com/coupons/show.action?....... 
                                                优惠券链接查询，支持优惠券链接集合： 上限10（GET请求）；上限50（POST请求或SDK调用）
 
返回参数说明 
 
名称 类型 示例值 说明
 
return 
 复制
 Int 
                                                0 
                                                0=返回成功
result 
 复制
 Array 
                                                 
                                                返回结果
> yn 
 复制
 String 
                                                是 
                                                券有效状态
> discount_price 
 复制
 Double 
                                                30 
                                                优惠券面额
> discount_link 
 复制
 String 
                                                https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoecg_UrvU1dXbnGZwaHG-kX1ibn7qQ71p80t_eAZUYDaTCTHZm_bQNB1YyiCx4oiMsYJZsqg 
                                                领券链接
> discount_num 
 复制
 Int 
                                                100000 
                                                券总张数
> remainNum 
 复制
 Int 
                                                95720 
                                                券剩余张数
> platform 
 复制
 String 
                                                全平台 
                                                券使用平台
> quota 
 复制
 Int 
                                                89 
                                                券消费限额
> useStartTime 
 复制
 Long 
                                                1595347200000 
                                                券有效使用开始时间(java精确到毫秒，其他语言精确到秒)
> useEndTime 
 复制
 Long 
                                                1596297599000 
                                                券有效使用结束时间(java精确到毫秒，其他语言精确到秒)
> get_start_time 
 复制
 Long 
                                                1595347200000 
                                                券领取开始时间(java精确到毫秒，其他语言精确到秒)
> get_end_time 
 复制
 Long 
                                                1596211199000 
                                                券领取结束时间(java精确到毫秒，其他语言精确到秒)
 
JSON返回示例 
 
    {
        "return": "0",
        "result": [
            {
                "platform": "全平台",
                "quota": 26,
                "remainNum": 4867,
                "yn": "是",
                "discount_price": 10,
                "discount_link": "https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeKseBzGMpeh0y8ajKXnhvX8t6TVi7mQfmMvCJyHQKzcLa0koZauhhaET00bdojzTZqMOylA",
                "discount_num": 5000,
                "useStartTime": 1613750400000,
                "useEndTime": 1614441599000,
                "get_start_time": 1613750400000,
                "get_end_time": 1614355199000
            }
        ]
    }

 
v3版本 更新时间: 2021-02-25 09:44:29
 
 
v3更新内容

                                                        该版本功能与v2版本基本一致，该版本返回参数为京推推开放平台统一参数
 

返回参数

1  原discount调整为discount_price：优惠券面额

2  原link调整为discount_link：领券链接

3  原num调整为discount_num：券总张数

4  原beginTime调整为useStartTime：券有效使用开始时间

5  原endTime调整为useEndTime：券有效使用结束时间

6  原takeBeginTime调整为get_start_time：券领取开始时间

7  原takeEndTime调整为get_end_time：券领取结束时间                        
 
v2版本 更新时间: 2021-02-25 09:43:55
 
 
v2更新内容

                                                        优惠券链接查询，支持优惠券链接集合，请求参数由原Url调整为couponUrls                        
 
错误码 说明
 
0 请求成功
 
1000 appid或appkey错误
 
2000 API次数调用超过上限
 
3000 API权限不足







	
		

			

				

					
					
					
				

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