个人拥有的优惠券

简要描述:

  • 获取某张优惠券不同使用时间点的列表

请求域名:

请求URL:

  • /addons/yun_shop/api.php?i=2&route=coupon.member-coupon.get-time-spread-coupon

参数:

参数名 是否必须 类型 说明
coupon_id int 优惠券id
coupon_type int 优惠券类型 0 全部 1平台 2门店 3酒店 4指定商品 5指定分类 6兑换券 7满减券 8折扣券 9快过期 10平台商品和门店

返回示例:

正确时返回:

{
    "result": 1,
    "msg": "成功",
    "data": [
        {
            "id": 7,
            "coupon_id": 3,
            "used": 0,
            "use_time": 0,
            "get_time": "2023-06-21 00:00:00",
            "near_expiration": 0,
            "num": 1,
            "time_start": "2023-06-21",
            "time_end": "2023-06-26 15:13:22",
            "timestamp_end": "2023-06-26 15:13:22",
            "belongs_to_coupon": {
                "id": 3,
                "name": "个确认过",
                "coupon_method": 1,
                "deduct": "0.00",
                "discount": "0.00",
                "enough": 1,
                "use_type": 6,
                "category_ids": null,
                "categorynames": null,
                "goods_ids": null,
                "goods_names": null,
                "storenames": null,
                "time_limit": 0,
                "time_days": 5,
                "time_start": "2023-06-21 00:00:00",
                "time_end": "2023-06-28 00:00:00",
                "total": 1000,
                "money": "0.00",
                "credit": 0,
                "plugin_id": 33,
                "use_conditions": null,
                "coupon_type_name": "酒店商品",
                "hotel_ids": 1
            },
            "combine": false,
            "api_limit": "适用于酒店 :"
        }
    ]
}

错误时返回:

{
    "result": 0, 
    "msg": "没有找到记录", 
    "data": [ ]
}

返回参数说明:

参数名 类型 说明
coupon_id int 优惠券 ID
used int 是否已使用( 0 未使用; 1 已使用)
get_time int 获取优惠券的时间 (Unix时间戳)
num int 折叠数量
combine bool 是否折叠
belongs_to_coupon.id int 优惠券ID
belongs_to_coupon.name str 优惠券名称
belongs_to_coupon.coupon_method int 优惠方式: 1为立减deduct, 2为折扣discount
belongs_to_coupon. deduct int 立减多少元(注意,coupon_method为1时,该数据才有意义)
belongs_to_coupon. discount float 折扣(注意,coupon_method为2时,该数据才有意义; 例子:7表示打7折,即原价的0.7倍)
belongs_to_coupon. enough int 消费满多少元, 优惠券才可用(空或0为不限制)
belongs_to_coupon. use_type int 适用范围,0商城通用 1指定分类 2指定商品
belongs_to_coupon. category_ids array 适用的分类ID (受belongs_to_coupon. use_type影响)
belongs_to_coupon. categorynames array 适用的分类名称 (受belongs_to_coupon. use_type影响)
belongs_to_coupon. goods_ids array 适用的商品ID(受belongs_to_coupon. use_type影响)
belongs_to_coupon. goods_names array 适用的商品范围(受belongs_to_coupon. use_type影响)
belongs_to_coupon. time_limit int 时间限制类型: 0 表示领取后几天有效, 1时间范围
belongs_to_coupon. time_days int 领取后几天有效(受belongs_to_coupon. time_limit影响)
belongs_to_coupon. time_start int 有效期的起始时间(受belongs_to_coupon. time_limit影响)
belongs_to_coupon. time_end int 有效期的终止时间(受belongs_to_coupon. time_limit影响)
belongs_to_coupon. total int 发放总数量限制( -1 为不限制)
belongs_to_coupon. start int 有效期
belongs_to_coupon. end int 有效期
belongs_to_coupon. api_limit str 适用范围的描述, 比如"适用于下列商品: 测试商品-电视1,99测试"