本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。
本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。使用 event_id 查询单条详情;不属于当前组织或日志类型的事件返回 404。
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
Content-Type: application/json
所需权限
| Scope | 资源服务 |
|---|---|
| admin.v1.user-logs.read | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。
Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| event_id | path | string · uuid | 是 | 事件 ID | - |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 200 | 请求成功 | 见本文“响应结果” | 读取结果。 |
| 401 | 身份认证失败 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 403 | 缺少对应 Scope 或可信身份无效 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 404 | 事件不存在或组织/类型不匹配 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 422 | 请求字段或时间窗口无效 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 503 | 上游或审计依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| default | 其他认证、业务或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| data | object | 否 | 日志详情数据;用户日志未采集时省略 | - |
| event_description | string | 是 | 事件描述 | - |
| event_id | string · uuid | 是 | 事件 ID | - |
| event_time | string · date-time | 是 | 事件发生时间 | - |
| event_type | string | 是 | 事件类型;用户日志为操作事件类型,AI 日志为 ai.turn; pattern="^[a-z][a-z0-9_]+$" | - |
| result | string | 是 | 执行结果; 取值:"success"、"failure" | - |
| session_id | string | null | 否 | 会话 ID;用户日志未采集时省略 | - |
| source | string | 是 | 事件来源; 取值:"pc" | - |
| source_ip | string | 是 | 来源 IP | - |
| user_email_snapshot | string | null | 是 | 事件发生时的邮箱快照;可为 null | - |
| user_id | string · uuid | 是 | 用户 ID | - |
| user_name_snapshot | string | 是 | 事件发生时的用户姓名快照 | - |
data
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| common | object | 是 | 受保护的公共维度对象;保留当前 UI 的扩展键和值 |
| extensions | object | 是 | 事件扩展对象;保留当前 UI 的扩展键和值 |