Skip to content

获取拼团活动列表

拥有此API的权限集
拼团管理-查询

请求方式及url

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://api.xiaoe-tech.com/xe.marketing.team_buy.list/1.0.0
  • 频率限制:10秒200次

接口调试

请求参数
响应结果
暂无响应数据

请求参数

参数名必选类型说明备注
access_tokenstring专属token...
team_buy_stateint拼团状态(0-未开始 1-进行中 2-已结束 3-已停止 4-已删除)...
pageint页码,第一页值传 1...

请求示例

{
    "access_token":"{{TOKEN}}",
    "team_buy_state":1,
    "page":1
}

返回参数

参数名必选类型说明备注(示例)
codeint请求结果码
msgstring描述信息
dataarray数据
data.listarray列表数据
data.pageobject页码数据

数据列表data.list

参数名类型说明备注(示例)
app_idstring店铺id
team_buy_idstring拼团活动id
team_buy_titlestring活动名称
team_buy_typestring拼团类型:0普通团1阶梯团2邀新团
team_buy_statusstring状态:0-未开始 1-进行中 2-已结束 3-已停止 4-已删除
start_atstring活动开始时间
stop_atstring活动结束时间
all_countint获取总团数量,即当前活动下面开了多个少团
complete_countint成功拼团数量
resource_idint资源id
resource_typeint资源类型
group_priceint拼团价
captain_priceint团长价
sum_numint参团人数,阶梯拼团时此值为0
stage_numsarray仅阶梯拼团有值:阶梯参团人数,这里是数组格式,数组中会有多个值,格式(举例)[3,5],表示第一阶梯参团人数3人团 ,第二阶梯参团人数5人团
created_atstring活动创建时间
share_urlstring分享连接,原链
short_urlstring分享连接,短链...

page页码数据

参数名类型说明
pagestring页码
totalstring总条数
page_sizestring固定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
        }
    }
}