优惠券信息查询API

¥免费基础接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/couponInfo

支持格式:json

请求方式:get

请求示例:http://api.tkurl.top/api/alimama/couponInfo?appkey=&item_id=123456&activity_id=asdawezdcsdfsdf

请求参数说明:

名称 类型 是否必须 示例值 描述
appkey String 必填 123456 appkey
e String 可选 nfr%2BYTo2k1PX18gaNN%2BIPkIG2PadNYbBnwEsv6mRavWieOoOE3L9OdmbDSSyHbGxBAXjHpLKvZbL1320ML%2BCF5FRtW7N7yJ056Lgym4X01A%3D 带券ID与商品ID的加密串
item_id String 可选 123 商品ID
activity_id String 可选 sdfwe3eefsdf 券ID
传入商品ID+券ID,或者传入e参数,均可查询券信息。

响应参数

名称 类型 示例值 描述
coupon_start_fee String 29.00 优惠券门槛金额
coupon_remain_count Number 26996 优惠券剩余量
coupon_total_count Number 30000 优惠券总量
coupon_end_time String 2017-08-17 优惠券结束时间
coupon_start_time String 2017-08-15 优惠券开始时间
coupon_amount String 10.00 优惠券金额
coupon_src_scene Number 1 券类型,1 表示全网公开券,4 表示妈妈渠道券
coupon_type Number 0 券属性,0表示店铺券,1表示单品券
coupon_activity_id String xsdss 券ID

响应示例

{
	"tbk_coupon_get_response": {
		"data": {
			"coupon_activity_id": "2477700178de4fa58e921f6ee6edf3cf",
			"coupon_amount": "500.0",
			"coupon_end_time": "2018-12-19",
			"coupon_remain_count": 96000,
			"coupon_src_scene": 4,
			"coupon_start_fee": "501.0",
			"coupon_start_time": "2018-12-13",
			"coupon_total_count": 100000,
			"coupon_type": 1
		},
		"request_id": "7wuxs5nze0uc"
	}
}
   

异常示例

{
	"error_response": {
		"code": 15,
		"msg": "Remote service error",
		"sub_code": "10",
		"sub_msg": "优惠券不存在",
		"request_id": "8n35q3gdedad"
	}
}
   

错误码解释

错误码 错误描述 解决方案
1001 非法的e参数值 传入正确的e参数值,含有券ID与商品ID信息
10000 该itemId对应的宝贝已下架或非淘客宝贝 更换新的itemId查询
1002 入参为空 入参为空
10 优惠券不存在 优惠券不存在
11 优惠券已领完 优惠券已领完
13 该优惠券不适用该商品 该优惠券不适用该商品
14 优惠券类型错误 优惠券类型错误
15 不支持的优惠券 不支持的优惠券
17 优惠券未到开始使用时间 优惠券未到开始使用时间
603 未找到用户或该用户未注册 请输入正确的appkey
404 参数传入错误_未知参数 检查参数类型是否正确