分组 Local API 文档

查询分组列表

标题

查询分组列表

简要描述

分页查询分组列表，支持按分组名称和归属用户筛选。

请求URL

http://127.0.0.1:54345/group/list

请求方式

POST

Header

请求Body参数

成功返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 2001,
        "group_name": "测试分组",
        "parent_id": 0,
        "sort_num": 0,
        "browserCount": 2
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 100
  }
}

成功返回示例的参数说明

备注

接口只监听本机 127.0.0.1，调用前请先打开并登录客户端。

新增分组

标题

新增分组

简要描述

创建一个新的浏览器分组。

请求URL

http://127.0.0.1:54345/group/add

请求方式

POST

Header

请求Body参数

成功返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2001,
    "group_name": "测试分组",
    "transferredBrowserIds": []
  }
}

成功返回示例的参数说明

备注

新增顶级分组时 parent_id 传 0 或不传。历史字段 parentCode 仍兼容。

编辑分组

标题

编辑分组

简要描述

修改指定分组的名称、父级、排序或归属信息。

请求URL

http://127.0.0.1:54345/group/edit

请求方式

POST

Header

请求Body参数

成功返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2001,
    "group_name": "新分组名",
    "transferredBrowserIds": []
  }
}

成功返回示例的参数说明

备注

编辑分组前可先调用 /group/list 或 /group/detail 获取分组 ID。

删除分组

标题

删除分组

简要描述

根据分组 ID 删除指定分组。

请求URL

http://127.0.0.1:54345/group/delete

请求方式

POST

Header

请求Body参数

成功返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2001
  }
}

成功返回示例的参数说明

备注

删除分组前请确认该分组下窗口的处理方式，具体结果以客户端和服务端当前逻辑为准。

查询分组详情

标题

查询分组详情

简要描述

根据分组 ID 查询分组详情。

请求URL

http://127.0.0.1:54345/group/detail

请求方式

POST

Header

请求Body参数

成功返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2001,
    "group_name": "测试分组",
    "parent_id": 0,
    "sort_num": 0,
    "browserCount": 2
  }
}

成功返回示例的参数说明

备注

如果分组不存在，可能返回 code: 404 和 msg: group not found。