开放平台

领用券用户列表

开发中

GET

https://saas-open.vhall.com/v3/goods/coupon/user-stats-list

账号维度，活动维度，调用的同一个接口。根据传入的参数区分是查用户的，还是活动的

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://saas-open.vhall.com/v3/goods/coupon/user-stats-list?pos=0&limit=20&coupon_id=1' \
--header 'platform: 15' \
--header 'Content-Type: application/json'

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "total": 0,
        "list": [
            {
                "user_name": "string",
                "phone": "string",
                "receive_type": 0,
                "receive_time": "string",
                "use_status": 0,
                "use_time": "string",
                "webinar_name": "string",
                "webinar_id": 0,
                "user_coupon_id": 0
            }
        ]
    },
    "trace_id": "string"
}

请求参数

Query 参数

time_type

string

可选

时间筛选类型：0领券时间 1用券时间

示例值:

begin_time

string

可选

开始时间，格式:yyyy-mm-dd H:i:s（年-月-日时:分:秒）

示例值:

2023-08-28 00:00:00

end_time

string

可选

结束时间，格式:yyyy-mm-dd H:i:s（年-月-日时:分:秒）

示例值:

2023-08-28 00:00:00

use_status

string

可选

使用状态 0已领取 1-已使用 2-已作废（全部时 - 不传或传null）

示例值:

search_type

string

可选

搜索类型：0按用户搜索 1按活动搜索

示例值:

keywords

string

搜索关键词

可选

示例值:

xxx

pos

string

翻页，起始值

必需

示例值:

limit

string

每页数据大小

必需

示例值:

coupon_id

string

优惠券ID

必需

示例值:

webinar_id

string

可选

活动ID（查看活动下数据时，需要传）

示例值:

Header 参数

Content-Type

string

必需

示例值:

application/json

platform

integer

可选

默认值:

返回响应

🟢200成功

application/json

Body

code

integer <int32>

错误码

可选

默认值:

200

msg

string

提示信息

可选

默认值:

success

data

object

订单返回体

可选

total

integer

总数

必需

list

array [object {9}]

必需

trace_id

string

追踪编号

可选

修改于 2025-05-28 05:26:25

获取活动下优惠券列表

修改活动商品