获取分组列表
简要描述#
分页获取分组列表,可按名称模糊搜索。
请求 URL#
公网域名:请联系客服获取域名
远程接口路径:/api/open/subset/get
本地:http://127.0.0.1:自定义端口/api/local/subset/get
请求方式#
GET
请求头 Headers#
| 请求头 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Authorization | 是 | string | Bearer <apiToken> |
- API Token 在 "其他功能 → API 接口" 生成
- 开启 "API 接口远程访问" 才能从远程调用
参数#
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| limit | 是 | number | 每页条数,最大 1000 |
| page | 是 | number | 页码 |
| name | 否 | string | 分组名称(模糊匹配) |
返回示例#
{
"status": 1000,
"msg": "操作成功",
"data": {
"count": 10,
"rows": [
{
"id": 1,
"name": "分组1",
"groupCount": 5,
"groupAmountSum": 1234.5678
}
]
}
}
返回字段#
| 字段 | 类型 | 说明 |
|---|---|---|
| count | number | 总数 |
| id | number | 分组 ID |
| name | string | 分组名称 |
| groupCount | number | 群数量 |
| groupAmountSum | number | 合计账单金额(4 位小数) |