用户管理
用户和用户分组管理。
查询用户分组
分页查询用户组,按用户组 ID 降序返回。默认第 1 页、每页 10 条;`limit=0` 时返回全部用户组。响应中的 `count` 为用户组总数。业务参数错误仍返回 HTTP 200,请依据 `code` 判断结果。
创建用户组
创建用户组。name 为必填且必须唯一,des 为可选备注。业务校验失败仍返回 HTTP 200,请依据响应中的 code 和 msg 判断结果。
删除用户组
删除一个或多个用户组。路径参数可使用英文逗号分隔多个用户组 ID。用户组必须存在,且组内不能仍有关联用户;否则返回相应业务错误。业务错误仍使用 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
获取用户组详情
根据用户组 ID 获取用户组完整信息。用户组不存在时返回业务错误 `user_group-3`;业务错误仍使用 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
更新用户组
更新指定用户组。路径中的 group_id 决定更新目标,请求体无需传 id。可更新 name 和 des;name 传入时不能为空且必须唯一。至少应实际变更一个字段,否则返回 user_group-14。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。
查询用户列表
管理员查询用户账户列表。支持分页和多种精确/模糊筛选;limit 传 0 时不分页。成功响应直接返回 code、count 和 data,不保证包含 msg。
创建用户
管理员创建用户账户。创建时必须提供邮箱、用户名、密码和账户类型;其他资料与认证/登录策略字段均可选。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。
批量更新用户
管理员更新一个或多个已有用户。集合接口请求体必须为 JSON 数组,每项必须包含 id;其余字段均为可选,未传字段保持原值。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。
删除用户
管理员删除一个或多个用户。路径参数可使用英文逗号分隔多个 ID。用户 ID 1 不允许删除;目标用户必须已禁用,且不存在网站或四层转发。删除后会同时清除该用户的配置、登录/操作日志、证书、DNS API、ACL、CC 规则、套餐、订单、任务、分组、消息订阅及 API 密钥等关联记录。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。
获取用户详情
管理员获取指定用户的完整原始账户记录。查询参数 token 传入任意非空值时,不返回用户资料,而是为目标普通用户生成登录令牌;不能为管理员账户生成该令牌。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。
更新指定用户
管理员更新指定用户。请求体必须为单个 JSON 对象;路径中的 user_id 会覆盖请求体中的 id,因此请求体不需要也不应传 id。其余字段均为可选,未传字段保持原值。业务错误仍使用 HTTP 200,请依据响应中的 code 和 msg 判断结果。