获取拼团活动列表
| 拥有此API的权限集 |
|---|
| 拼团管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.marketing.team_buy.list/1.0.0 - 频率限制：
10秒200次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 | 备注 |
|---|---|---|---|---|
| access_token | 是 | string | 专属token | ... |
| team_buy_state | 否 | int | 拼团状态(0-未开始 1-进行中 2-已结束 3-已停止 4-已删除) | ... |
| page | 是 | int | 页码，第一页值传 1 | ... |
请求示例
{
"access_token":"",
"team_buy_state":1,
"page":1
}
返回参数
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| code | 是 | int | 请求结果码 | |
| msg | 是 | string | 描述信息 | 无 |
| data | 是 | array | 数据 | 无 |
| data.list | 是 | array | 列表数据 | 无 |
| data.page | 是 | object | 页码数据 | 无 |
数据列表data.list
| 参数名 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|
| app_id | string | 店铺id | |
| team_buy_id | string | 拼团活动id | |
| team_buy_title | string | 活动名称 | |
| team_buy_type | string | 拼团类型:0普通团1阶梯团2邀新团 | |
| team_buy_status | string | 状态：0-未开始 1-进行中 2-已结束 3-已停止 4-已删除 | |
| start_at | string | 活动开始时间 | |
| stop_at | string | 活动结束时间 | |
| all_count | int | 获取总团数量，即当前活动下面开了多个少团 | |
| complete_count | int | 成功拼团数量 | |
| resource_id | int | 资源id | |
| resource_type | int | 资源类型 | |
| group_price | int | 拼团价 | |
| captain_price | int | 团长价 | |
| sum_num | int | 参团人数，阶梯拼团时此值为0 | |
| stage_nums | array | 仅阶梯拼团有值：阶梯参团人数，这里是数组格式，数组中会有多个值，格式(举例) | [3,5]，表示第一阶梯参团人数3人团 ，第二阶梯参团人数5人团 |
| created_at | string | 活动创建时间 | |
| share_url | string | 分享连接，原链 | |
| short_url | string | 分享连接，短链 | ... |
page页码数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| page | string | 页码 |
| total | string | 总条数 |
| page_size | string | 固定10条 |
返回示例
{
"code": 0,
"msg": "success",
"data": {
"list": [
{
"all_count": 0,
"app_id": "appxxx",
"captain_price": 1,
"complete_count": 0,
"content_app_id": "",
"content_resource_id": "",
"content_resource_type": 0,
"created_at": "2023-11-14 16:20:01",
"group_price": 1,
"has_spec": 0,
"money_count": 0,
"order_count": 0,
"resource_id": "course_xxx",
"resource_type": 50,
"share_url": "https://xxx",
"short_url": "https://xxx",
"stage_nums": [],
"start_at": "2023-11-14 16:19:22",
"stop_at": "2023-11-30 00:00:00",
"sum_num": 2,
"team_buy_id": "tb_xxx",
"team_buy_status": 1,
"team_buy_title": "yeleon拼团",
"team_buy_type": 0
}
],
"page": {
"page": 1,
"page_size": 10,
"total": 8
}
}
}