菜单

获取某个会员的优惠券列表

接口说明

该接口用于获取某个会员的优惠券列表；

注意事项

无

基本信息

名称	描述
HTTP URL	https://open.shengyi.pro/coupon/v1/coupon
HTTP Method	GET

请求参数

请求头

content-type 必填 string
示例：application/json
固定值：application/json

参数

appid 必填 string
示例：10000000000
应用唯一标识，可以从众流生意app中的开放平台中获取

client_token 必填 string
示例：laOVEe3aNYY*****
用户授权令牌

simple 必填 int
示例：1
固定值：1

paginate_type 必填 int
示例：1
固定值：1

current_page 必填 int
示例：1
当前页

per_page 必填 int
示例：30
每页数，最大为100

vip_id 必填 string
示例：dnA0Q1V5bGdXbFFkaW5MOUdlQVY1dz09
会员id

请求示例

shell 复制代码

curl --location --request GET 'https://open.shenyi.pro/coupon/v1/coupon?client_token=laOVEe3aNYY*****&simple =1&paginate_type=1&current_page=1&per_page=30&vip_id=dnA0Q1V5bGdXbFFkaW5MOUdlQVY1dz09 \
--header 'Content-Type: application/json' \

响应参数

参数

code int
示例：200
请求响应

message string
示例：请求成功
请求响应

data struct

id string
示例：V3FodFhEa0xzU0JUTzJnd0ZXSzdtdz09
优惠券模板id

coupon_mould_name string
示例：测试
优惠券名称

head_url string
示例：https://zhongliulingshou.oss-cn-hangzhou.aliyuncs.com/knifeAppCloudStorage/95883117100/1732954725439_微信图片_20210902095629.jpg
logo地址

auth_code string
示例：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
优惠券名称

coupon_mould_type_id int
示例：1
优惠券模板类型，2代金券（用一次就消失），4余额券（可以多次使用），5时长券（用一次就消失）

coupon_mould_limit_type_id int
示例：1
可用时间类型，1固定范围，2N天可用，3永不过期

coupon_start_time string
示例：2024-12-03 00:00:00
可用开始时间，仅可用时间类型为固定范围时有效

coupon_end_time string
示例：2024-12-04 00:00:00
可用结束时间，仅可用时间类型为固定范围时有效

coupon_least_money int
示例：100
优惠券起始金额，达到这个金额时方可使用，仅优惠券模板类型为代金券时有效，单位：分

coupon_reduce_money int
示例：100
优惠券减免金额，达到这个金额时方可使用，仅优惠券模板类型为代金券时有效，单位：分

coupon_least_time int
示例：100
优惠券起始时长，达到这个时长时方可使用，仅优惠券模板类型为时长券时有效，单位：分钟

coupon_reduce_time int
示例：100
优惠券减免时长，达到这个时长时方可使用，仅优惠券模板类型为时长券时有效，单位：分钟

denomination int
示例：100
面额，仅优惠券模板类型为余额券时有效，单位：分

coupon_type_id int
示例：1
优惠券状态，2代金券，4余额券，5时长券

coupon_status_id int
示例：1
优惠券状态，1未使用，2已使用，3已失效，4未开始

coupon_cancel_status_id int
示例：1
优惠券注销状态，1未注销，2已注销

响应示例

json 复制代码

{
    "requestId": "22a58553eab3c03c576782954e4736b7",
    "code": 200,
    "message": "请求成功",
    "data": {
        "total": 3315,
        "per_page": "1",
        "current_page": 1,
        "last_page": 3315,
        "attach": null,
        "data": [
            {
                "id": "b1d4elR0VEJXVVA2bm15L3dLN3Rqdz09",
                "coll_id": "TVE1WW5iRE1NaUdMbytkS2dXR2VGUT09",
                "merchant_id": "elpZWWVoeWt3NU1wUkRaYzBYcUJSQT09",
                "merchant_name": "马上发🍃",
                "coupon_id": "b1d4elR0VEJXVVA2bm15L3dLN3Rqdz09",
                "auth_code": "ZH33917371102775343259",
                "vip_id": "WEUxVmpKOVBaeHdneGlSVTBZWXQrUT09",
                "coupon_mould_id": "TCtadm5UN3hHWStRb1dEVm1qZmxOdz09",
                "coupon_mould_name": "文龙时长劵",
                "order_goods_id": "WEUxVmpKOVBaeHdneGlSVTBZWXQrUT09",
                "head_url": "https://zhongliulingshou.oss-cn-hangzhou.aliyuncs.com/knifeAppCloudStorage/95883117100/1711532708385_微信图片_20240326133140.jpg",
                "coupon_put_in_id": "WEUxVmpKOVBaeHdneGlSVTBZWXQrUT09",
                "coupon_color_id": "Ni9FL1dYaWxWY0h5UElSZlpPYk9QUT09",
                "coupon_start_time": "2025-01-17 18:37:57",
                "coupon_end_time": "2050-01-01 00:00:00",
                "coupon_least_money": 0,
                "coupon_reduce_money": 0,
                "coupon_least_time": 0,
                "coupon_reduce_time": 60,
                "goods_id": "WEUxVmpKOVBaeHdneGlSVTBZWXQrUT09",
                "denomination": 0,
                "balance": 0,
                "coupon_discount": 0,
                "description": "",
                "coupon_mould_type_id": 5,
                "coupon_mould_time_type_id": 3,
                "coupon_wechat_status_id": 1,
                "coupon_status_id": 1,
                "coupon_type_id": 5,
                "coupon_cancel_status_id": 1,
                "create_time": "2025-01-17 18:37:57",
                "vip": null,
                "coupon_mould": {
                    "id": "TCtadm5UN3hHWStRb1dEVm1qZmxOdz09",
                    "coll_id": "TVE1WW5iRE1NaUdMbytkS2dXR2VGUT09",
                    "merchant_id": "bmE3eDEyY3dhM29hMzAwRitVeXFtQT09",
                    "merchant_name": "文龙超级管理员",
                    "coupon_mould_name": "文龙时长劵",
                    "head_url": "https://zhongliulingshou.oss-cn-hangzhou.aliyuncs.com/knifeAppCloudStorage/95883117100/1711532708385_微信图片_20240326133140.jpg",
                    "coupon_color_id": "Ni9FL1dYaWxWY0h5UElSZlpPYk9QUT09",
                    "coupon_start_time": null,
                    "coupon_end_time": null,
                    "coupon_mould_postpone": 2,
                    "coupon_mould_day": 2,
                    "description": "",
                    "coupon_least_money": 0,
                    "coupon_reduce_money": 0,
                    "coupon_discount": 0,
                    "coupon_least_time": 0,
                    "coupon_reduce_time": 60,
                    "coupon_mould_num_limit": 2,
                    "goods_id": "WEUxVmpKOVBaeHdneGlSVTBZWXQrUT09",
                    "denomination": 0,
                    "password": "",
                    "coupon_mould_type_id": 5,
                    "coupon_mould_time_type_id": 3,
                    "coupon_mould_limit_type_id": 1,
                    "coupon_wechat_status_id": 1,
                    "coupon_mould_online_status_id": 2,
                    "coupon_mould_offline_status_id": 1,
                    "remark": "",
                    "create_time": "2024-03-27 17:45:09"
                },
                "coupon_type": {
                    "id": "K08vSDFjV1I0V3ZDcWNjbGcyT2hlQT09",
                    "coupon_type_name": "时长券",
                    "coupon_type_name_en": "Duration voucher",
                    "create_time": null
                },
                "coupon_status": {
                    "id": "Ni9FL1dYaWxWY0h5UElSZlpPYk9QUT09",
                    "coupon_status_name": "未使用",
                    "coupon_status_name_en": "",
                    "remark": "",
                    "remark_en": "",
                    "create_time": null
                },
                "coupon_cancel_status": {
                    "id": "Ni9FL1dYaWxWY0h5UElSZlpPYk9QUT09",
                    "coupon_cancel_status_name": "未注销",
                    "coupon_cancel_status_name_en": "Unregistered",
                    "create_time": null
                }
            }
        ]
    },
    "time": 1737340788
}

上一个

给会员发放优惠券

下一个

订单

最近修改: 2025-01-20Powered by

大纲