Skip to main content

获取用户日志详情接口

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。使用 event_id 查询单条详情;不属于当前组织或日志类型的事件返回 404。

所需权限

Scope资源服务
admin.v1.user-logs.readqwenwork-biz-service
GET /api/openapi/v1/user-logs/{event_id}

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。 Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

名称位置类型必填说明示例
event_idpathstring · uuid是事件 ID-

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl '<BASE_URL>/api/openapi/v1/user-logs/{event_id}' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

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
名称类型必填说明示例
dataobject否日志详情数据;用户日志未采集时省略-
event_descriptionstring是事件描述-
event_idstring · uuid是事件 ID-
event_timestring · date-time是事件发生时间-
event_typestring是事件类型;用户日志为操作事件类型,AI 日志为 ai.turn; pattern="^[a-z][a-z0-9_]+$"-
resultstring是执行结果; 取值:"success"、"failure"-
session_idstring | null否会话 ID;用户日志未采集时省略-
sourcestring是事件来源; 取值:"pc"-
source_ipstring是来源 IP-
user_email_snapshotstring | null是事件发生时的邮箱快照;可为 null-
user_idstring · uuid是用户 ID-
user_name_snapshotstring是事件发生时的用户姓名快照-

data

字段类型必填说明
commonobject是受保护的公共维度对象;保留当前 UI 的扩展键和值
extensionsobject是事件扩展对象;保留当前 UI 的扩展键和值

响应示例

{
  "event_id": "11111111-1111-4111-8111-111111111111",
  "event_type": "login",
  "event_description": "Signed in",
  "event_time": "2026-10-26T08:00:00Z",
  "user_id": "22222222-2222-4222-8222-222222222222",
  "user_name_snapshot": "Alice",
  "user_email_snapshot": null,
  "result": "success",
  "source_ip": "192.0.2.1",
  "source": "pc",
  "session_id": "session-1",
  "data": {
    "common": {
      "staff_id": "007"
    },
    "extensions": {
      "enabled": false
    }
  }
}