---
url: /docs/api-docs/v1/admin/misc.md
---
# misc — 杂项（审计/日志/字典/通知）（5 action · 全只读）

> 前缀：`/api/v1/admin/misc/`
> 权限：全部 `MISC_READ` — 仅 **super + it**，operator 一律 403
> 代码：`src/app/admin/interface/api/misc_mgmt.py` + `application/usecase/misc_mgmt.py`
> ⚠️ §3.12.5 POST（MISC\_WRITE）不在九权限矩阵 — P3 仅实现 GET

## 3.12.1 audit-logs —— 审计日志（审计闭环回查点）

`GET /api/v1/admin/misc/audit-logs` · 权限 `MISC_READ`

P1 起全部写操作（`operator_id` + `before` / `after` + `ip` + `ua`）的审计留痕，在此闭环回查。

**Query 参数**：

| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| `page` | int | ⬜ | 1 | ≥1 |
| `page_size` | int | ⬜ | 20 | 1~100 |
| `admin_id` | string | ⬜ | — | 按操作 admin 过滤 |
| `action_type` | string | ⬜ | — | 动作类型（如 `ADMIN_LOGOUT` / `ADMIN_IMPERSONATE`） |
| `date_from` / `date_to` | string | ⬜ | — | ISO 日期区间 |

**响应 data**：`{ total, page, page_size, items: [AuditLog 原始记录] }`（含 `operator_id` / `action` / `before` / `after` / `ip` / `ua` / `created_at`）

**错误码**：`40201001` 日期格式非法；`40201761` 查询失败（防御性 — 只读路径无自然触发）。

## 3.12.2 operation-logs —— 操作日志

`GET /api/v1/admin/misc/operation-logs` · 权限 `MISC_READ`

**Query**：`page` / `page_size` / `level` / `date_from` / `date_to`

**响应 data**：`{ total, page, page_size, items }`

**错误码**：`40201001`。

## 3.12.3 error-logs —— 错误日志

`GET /api/v1/admin/misc/error-logs` · 权限 `MISC_READ`

**Query**：`page` / `page_size` / `severity` / `module` / `date_from` / `date_to`

**响应 data**：`{ total, page, page_size, items }`

**错误码**：`40201001`。

## 3.12.4 data-dictionary —— 数据字典（只读双入口）

`GET /api/v1/admin/misc/data-dictionary` · 权限 `MISC_READ`

与 [config/dictionary](/api-docs/v1/admin/config) **同源双入口**：本入口 MISC\_READ 只读（取证/排查视角），CRUD 在 config 域（CONFIG\_WRITE）。

**Query**：`type`（可选）

**响应 data**：`{ "total": <n>, "items": [{type, code, label, value, sort}] }`

## 3.12.5 notifications —— 站内通知

`GET /api/v1/admin/misc/notifications` · 权限 `MISC_READ`

（提现审批 / 订单退款 / 授权失效等链路落库的通知，分页回查。）

**Query**：

| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| `page` | int | ⬜ | 1 | ≥1 |
| `page_size` | int | ⬜ | 20 | 1~100 |
| `target_role` | string | ⬜ | — | 面向角色过滤 |

**响应 data**：`{ total, page, page_size, items }`

**错误码**：`40201001`。

***

**本域错误码汇总**：`40201761`-`40201762`（§6.9 misc 区段 — 防御性）。通用失败见 [admin 总览](/api-docs/v1/admin/)。