用户管理
管理员维护用户及用户分组。
查询用户分组列表
分页查询用户分组,按分组 ID 倒序返回。。该接口返回当前请求范围内的业务结果;业务错误仍通过 HTTP 200 返回,并由 code 字段判断。
创建用户分组
创建用户分组。兼容行为:请求体提供已有 `id` 时会更新已有分组,但成功消息仍为“用户组添加成功”;兼容更新时至少必须有一个字段与原记录不同。请求中的 `uid` 会被解析但不参与当前用户分组处理。
删除用户分组
删除一个或多个用户分组。路径参数可用英文逗号分隔多个 ID,服务端按顺序处理;任一分组不存在或仍有关联用户时会中止,因此不应将该操作视为原子批量删除。
查询指定用户分组
查询指定用户分组的完整记录。该详情接口不使用列表分页参数。
更新指定用户分组
更新指定用户分组的名称或说明。请求体必须为 JSON 对象,路径参数确定目标分组;未产生任何字段变更时会返回业务错误。`uid` 字段可被解析但不参与当前处理。
查询用户列表
分页查询用户,按用户 ID 倒序返回。`search` 对 ID、邮箱、用户名和手机号做完全匹配;email、name、cert_name、des、phone、qq 使用包含匹配。仅 page 与 limit 校验为数字;limit=0 时返回全部匹配记录。成功响应使用 code/count/data,不含 msg。
创建用户
创建一个用户账号,并初始化默认消息订阅。需要管理员权限。请求体必须是 JSON 对象;用户 ID 由系统生成。
批量更新用户
批量更新用户资料和账户状态。请求体必须为 JSON 数组;每个元素独立校验和更新,任一元素失败则返回错误。兼容行为:空数组会直接写入空内容操作日志并返回成功,不会更新任何用户。
删除用户
删除一个或多个用户。需要管理员权限。路径参数 id 支持单个数字 ID 或以逗号分隔的多个数字 ID;会依次校验所有目标。删除前用户必须已禁用,且没有网站或四层转发。成功后会同时清理用户配置、登录与操作日志、认证、DNS、ACL、CC 规则、套餐、订单、任务、分组、消息订阅和 API 密钥等关联记录。
查询用户详情或生成代登录令牌
查询指定用户的完整数据库记录。默认分支会返回密码哈希等敏感字段,调用方必须按敏感数据处理。若 query 参数 token 为任意非空值,则不返回详情,而是为非管理员类型用户生成临时代登录令牌。需要管理员权限。
更新指定用户
更新一个指定用户的资料和账户状态。需要管理员权限。请求体必须为 JSON 对象;路径参数 id 决定更新目标,并会覆盖请求体中同名的 id 字段。