获取用户统计信息
2026/3/8大约 2 分钟
获取用户统计信息
获取用户统计数据,包括总用户数、总检查次数和未通过检查次数。此接口需要管理员权限。
接口地址:GET /user/info/get_user_counts
请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定值:application/json |
| Authorization | 是 | Bearer token,用户认证令牌 |
请求参数
无
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | int | 是 | HTTP 状态码 |
| code | string | 是 | 查询结果代码 |
| result | string | 是 | 查询结果 |
| data | dict | 是 | 查询结果数据 |
data 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| total_users | int | 是 | 注册用户总数(去重统计) |
| total_checks | int | 是 | 检查记录总数 |
| failed_checks | int | 是 | 未通过检查记录总数 |
成功响应示例
{
"status": 200,
"code": "10000",
"result": "获取统计信息成功",
"data": {
"total_users": 150,
"total_checks": 320,
"failed_checks": 15
}
}错误响应示例
接口未开放
{
"status": 403,
"code": "10002",
"result": "服务器未开放此接口",
"data": {}
}token 已过期或无效
{
"status": 401,
"code": "10001",
"result": "token 已过期或无效",
"data": {}
}该账号不是管理员账号
{
"status": 401,
"code": "10004",
"result": "该账号不是管理员账号",
"data": {}
}获取统计信息失败,服务器内部错误
{
"status": 500,
"code": "10003",
"result": "获取统计信息失败,服务器内部错误",
"data": {}
}错误代码说明
| 代码 | 说明 |
|---|---|
| 10000 | 获取统计信息成功 |
| 10001 | token 已过期或无效 |
| 10002 | 服务器未开放此接口 |
| 10003 | 获取统计信息失败,服务器内部错误 |
| 10004 | 该账号不是管理员账号 |
权限要求
此接口需要用户具有以下角色之一:
管理员超级管理员组织管理员
提示
此接口需要用户登录且具有管理员权限后才能访问,需要在请求头中携带有效的 Authorization token。