查询管理操作记录¶
请求参数¶
仅后台web客户端。必须使用HTTPS和JWE;八项公共元数据必填,clientType=admin、platform=web、channel=admin_web。客户端类型不是管理员认证,App Bearer不能调用后台。
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
| page | integer | 否 | 默认1,1–100000 |
| pageSize | integer | 否 | 默认20,1–100 |
请求示例¶
通过管理员统一请求约定加密后发送,下面表示解密后的业务内容。外层使用Accept: application/jose;GET无正文,密文置X-Budyoo-JWE。写请求Origin必须与后台源一致,会话操作另带X-Admin-CSRF;HttpOnly Cookie由浏览器自动携带。
无业务JSON正文;查询参数按上表发送。
成功响应¶
HTTP200,Cache-Control:no-store。实际外层为JWE,解密后示例:
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"items": [
{
"id": "22222222-2222-4222-8222-222222222222",
"actor": "admin",
"action": "VIP_GATE_UPDATE",
"target": "global.vipGateEnabled",
"result": "SUCCESS",
"requestId": "33333333-3333-4333-8333-333333333333",
"beforeValue": "false",
"afterValue": "true",
"createdAt": "2026-11-03T00:00:00Z"
}
],
"total": 1,
"page": 1,
"pageSize": 20
},
"errors": []
}
时间降序再id降序。actor在匿名拒绝时为null;action为LOGIN/LOGOUT/PASSWORD_CHANGE/VIP_GATE_UPDATE,result为SUCCESS/DENIED。beforeValue/afterValue仅配置操作有值,其余null;不含密码或完整用户资料。无修改、删除审计入口。
失败响应¶
| HTTP | code | 条件 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED | JSON、查询参数或字段校验失败 |
| 400 | INVALID_CLIENT_HEADERS | 元数据缺失/重复/不合法 |
| 400 | ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST | 缺少真实JWE或认证失败 |
| 401 | UNAUTHORIZED | 会话无效、失效、安装不匹配或误用App凭证 |
| 403 | FORBIDDEN/ADMIN_CSRF_INVALID | 权限不足、来源或CSRF不符 |
| 426 | HTTPS_REQUIRED | 通过HTTP发送后台请求 |
| 429 | TOO_MANY_REQUESTS | 来源IP或网关限流 |
| 503 | SERVICE_UNAVAILABLE | 持久存储或Redis依赖不可用 |
错误按四语公共协议返回,不泄露密码、Cookie或内部异常;无法解密前的错误没有加密响应上下文,不作为已认证业务结果。
接入说明¶
所有安全和会话约定见后台登录协议,权限由后端每次请求核验。正式凭证不通过未信任TLS链路发送。已通过服务器隔离数据库回归,覆盖独立身份、权限、字段校验和对应失败分支;旧环境曾使用已明确信任的IP证书完成浏览器登录、改密、列表、配置及审计检查。当前域名公共CA证书已签发,后台公网入口已发布并完成服务器内TLS校验,管理员创建/角色编辑及用户管理写操作仍待实现。