使用 Authorization: Bearer <API_KEY>。各 Scope 独立授权。响应不应缓存。
使用
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
Content-Type: application/json
保留现有 UI 服务的错误码与校验。401/403 表示认证或授权失败;409 表示冲突,应重新读取后重试;413 表示请求过大;400/422 表示参数校验失败;503 表示依赖不可用。
以实际响应及机器契约为准。创建类幂等操作重试应使用相同 Idempotency-Key 与相同请求。
Authorization: Bearer <API_KEY>。各 Scope 独立授权。响应不应缓存。与管理员日志 UI 使用同一查询服务和 Console 查询模式:按时区限制为最多 7 个自然日,支持 q、重复 action_codes、category、result、range、timezone、from/to 与分页。page_size 为 10/20/50/100。响应包含 effective_from/effective_to。已有 GET /audit-logs 的游标拉取接口不变。本接口仅查询管理员日志;用户日志与 AI 日志分别使用 /user-logs 与 /ai-logs 及各自独立的敏感读取 Scope。
所需权限
| 所需权限 | 资源 | Scope | 资源服务 |
|---|---|---|---|
| 管理员日志读取(read) | audit-logs | admin.v1.audit-logs.read | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。
Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| q | query | string | 否 | 搜索关键词; maxLength=200 | - |
| action_codes | query | array<string> | null | 否 | 操作代码列表 | - |
| category | query | string | 否 | 分类名称; maxLength=64 | - |
| result | query | string | 否 | result; enum=["success", "failure", "partial_success"] 取值:"failure"、"partial_success"、"success" | - |
| range | query | string | 否 | range; enum=["last7"], default="last7" default="last7" 取值:"last7" | - |
| timezone | query | string | 否 | 时区; maxLength=128 | - |
| from | query | string · date-time | 否 | 时间范围起点; format="date-time" | - |
| to | query | string · date-time | 否 | 时间范围终点; format="date-time" | - |
| page | query | integer · int64 | 否 | 页码,从 1 开始; format="int64", minimum=1, default=1 default=1 | - |
| page_size | query | integer · int64 | 否 | 每页条数; format="int64", enum=[10, 20, 50, 100], default=20 default=20 取值:10、100、20、50 | - |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 200 | 请求成功 | 见本文“响应结果” | 读取响应结果。 |
| default | 未单独列出的认证、授权、校验或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态与 code 处理;写操作重试前核实结果及幂等要求。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| effective_from | string · date-time | 是 | 生效开始时间; format="date-time" | - |
| effective_to | string · date-time | 是 | 生效结束时间; format="date-time" | - |
| items | array<object> | null | 是 | 结果列表 | - |
| page | integer · int64 | 是 | 页码,从 1 开始; format="int64" | - |
| page_size | integer · int64 | 是 | 每页条数; format="int64" | - |
| total | integer · int64 | 是 | 符合筛选条件的总记录数; format="int64" | - |
items[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action_code | string | 是 | 操作 |
| actor_email_snapshot | string | 否 | 操作人邮箱(操作时快照) |
| actor_name_snapshot | string | 否 | 操作人姓名(操作时快照) |
| actor_qid_snapshot | string | 是 | 操作人 QID(操作时快照) |
| actor_user_id | string | 是 | 操作人 ID |
| after_display | string | null | 是 | 变更后内容 |
| before_display | string | null | 是 | 变更前内容 |
| category | string | 是 | 日志分类 |
| detail_attributes | object | 是 | 详情属性 |
| detail_code | string | 否 | 详情代码 |
| detail_text | string | 否 | 操作详情 |
| event_id | string | 是 | 事件 ID |
| occurred_at | string · date-time | 是 | 操作时间; format="date-time" |
| resource_id | string | 否 | 资源 ID |
| resource_label | string | 否 | 操作对象 |
| resource_type | string | 是 | 资源类型 |
| result | string | 是 | 操作结果 |
| source | string | 是 | 来源 |
| source_ip | string | 否 | 来源 IP |
| success_count | integer · int64 | 否 | 成功数量; format="int64" |
| target_count | integer · int64 | 否 | 目标用户数; format="int64" |
| trace_id | string | 否 | 链路追踪 ID |