查询分组
基本信息
GET /api/v1/group/list
接口描述:查询分组信息,分组信息包括分组ID和分组名称,其中分组ID用于添加账号时给账号分组,分组ID为0是系统创建的默认分组
请求参数
Query 非必需参数可以不传递
参数名称 | 必需 | 默认值 | 示例 | 说明 |
---|---|---|---|---|
group_name | 否 | - | group1 | 指定分组名称查询分组,默认空查所有分组 |
page | 否 | 1 | 1 | 页码默认1第一页 |
page_size | 否 | 1 | 10 | 每页条数默认1条,最大2000 |
返回数据
//执行成功
{
"code": 0,
"data": {
"list": [
{
"group_id": "100", //分组ID,添加账号时需要
"group_name": "group1" //分组名称
"remark": "xxxx" //分组备注
},
{
"group_id": "101",
"group_name": "group2"
"remark": "xxxx" //分组备注
}
],
"page": 1,
"page_size": 10
},
"msg": "Success"
}
//执行失败
{
"code":-1,
"data":{},
"msg":"failed"
}