优惠券查询接口 - shoufuyou/Shoufuyou-SDK-Doucument-for-core-client GitHub Wiki


<<返回文档首页

功能描述

method: coupon.query
用户请求信用飞查询优惠券。

请求参数说明

参数 参数名称 类型 必填 描述 范例
mobile 手机号 String 用户手机号
status 状态 String 优惠券状态 'none','unused','used','invalid'。默认:unused

请求参数示例

{
    "mobile": "139055842147"
}

响应参数说明

参数 参数名称 类型 描述 范例
code 返回的结果码 String 10000- 成功生成订单;非10000为错误码 10000
message 返回结果码对应的字符串解释 String 如code参数里的描述 请求成功 如果成功生成交易单则应答里包含下述结果
id 用户优惠券id String 用户优惠券id 1001001
discount_type 优惠类型 String 优惠类型 立减:price_reduce;利息折扣:fee_discount;票价折扣:price_discount
discount_amount 优惠金额(分) String 优惠金额 100
discount_rate 折扣率(0-1) String 折扣率 0.5
periods 可使用期数 String 可使用期数 3,6或者all
start_time 可使用起始时间 String 可使用起始时间 2018-01-26 15:32:00
end_time 可使用截止时间 String 可使用截止时间 2018-03-23 14:14:00
product_type 可使用产品类型 String 可使用产品类型 flight,freetour或者all
tourist_number 可使用出行成人数 String 可使用出行成人数 2或者all
departure 可使用出发地 String 可使用出发地 上海
destination 可使用目的地 String 可使用目的地 北京
product_name 可使用产品名中需要包含字串 String 可使用产品名中需要包含字串 #特惠产品#
status 优惠券状态 String 优惠券状态:未使用 unused;已使用 used;已强制失效 invalid; unused
upper_price 可使用订单金额上限(分) String 可使用订单金额上限(分) 200000
lower_price 可使用订单下限(分) String 可使用订单下限(分) 100000
valid_used_times 当前优惠券可使用次数 String 当前优惠券可使用次数 1
used_times 已使用次数 String 已使用次数 0
template_id 优惠券模板id String 优惠券模板id 124
terminal 可使用终端类型 String 可使用终端类型:pc,ios,android,wap all
discount_upper_amount 优惠券上限 String 优惠券使用上限
discount_lower_amount 优惠券下限 String 优惠券使用下限
valid_days 有效天数 String 优惠券自领取日起有效天数
issued_coupon_number 已生成优惠券总数 String 对优惠券模板而言(已生成优惠券总数)
type 优惠类型 String 优惠类型 activitt、sdk

响应参数示例

{
    "coupons":[
        {
            "id":515,
            "discount_amount":500,
            "created_time":"2018-04-12 15:41:48",
            "periods":1,
            "start_time":"2018-04-12 15:39:00",
            "end_time":"2018-12-31 00:00:00",
            "product_type":"all",
            "tourist_number":"all",
            "terminal":"all",
            "departure":"all",
            "destination":"all",
            "product_name":"",
            "discount_type":"price_reduce",
            "status":"valid",
            "upper_price":500000,
            "lower_price":0,
            "valid_used_times":1,
            "used_times":0,
            "coupon_number":500,
            "discount_upper_amount":0,
            "discount_lower_amount":0,
            "valid_days":0,
            "issued_coupon_number":108,
            "type":"sdk",
            "rule":"2期,2018-04-12 15:39:00 到2018-12-31 00:00:00",
            "channel_type":"sdk",
            "template_id":515,
            "discount_name":null
        }
    ],
    "code":"10000",
    "message":"请求成功"
}
⚠️ **GitHub.com Fallback** ⚠️