获取分组列表

简要描述#

分页获取分组列表,可按名称模糊搜索。

请求 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 位小数)