本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。
本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。业务字段、筛选和返回结构与控制台一致。查询及导出最多七个自然日;用户日志 VPC 保留 90 天、K8S 保留 180 天,AI 日志保留 90 天。时间窗口由服务端按保留期截断,返回 effective_from/effective_to。
适用《通过 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 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| user_name | query | string | 否 | 用户姓名筛选; maxLength=200 | - |
| auxiliary_identifier | query | string | 否 | 辅助标识类型;与辅助标识值配合使用; maxLength=200 | - |
| auxiliary_value | query | string | 否 | 辅助标识值;提供时必须指定 EMAIL、PHONE、EMPLOYEE_NO 或 ACCOUNT 类型; maxLength=200 | - |
| action | query | string | 否 | 操作类型; maxLength=200 | - |
| description | query | string | 否 | 操作描述筛选; maxLength=200 | - |
| source_ip | query | string | 否 | 来源 IP; maxLength=200 | - |
| q | query | string | 否 | 搜索关键词; maxLength=200 | - |
| result | query | string | 否 | 执行结果; 取值:"success"、"failure" | - |
| range | query | string | 否 | 默认查询最近七个自然日;提供 from/to 时忽略此项; default="last7"; 取值:"last7" | - |
| from | query | string · date-time | 否 | 起始时间;必须与 to 一起提供,最多七个自然日 | - |
| to | query | string · date-time | 否 | 结束时间;必须晚于 from;窗口按 UI 保留期截断 | - |
| department_id | query | string · uuid | 否 | 部门 ID 筛选 | - |
| page | query | integer · int64 | 否 | 页码,从 1 开始; minimum=1; default=1 | - |
| page_size | query | integer · int64 | 否 | 每页条数; default=20; 取值:10、20、50、100 | - |
| timezone | query | string | 否 | IANA 时区;省略时使用 UTC; maxLength=64 | - |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 200 | 请求成功 | 见本文“响应结果” | 读取结果。 |
| 401 | 身份认证失败 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 403 | 缺少对应 Scope 或可信身份无效 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 422 | 请求字段或时间窗口无效 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| 503 | 上游或审计依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
| default | 其他认证、业务或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 检查状态与 code;修正参数或授权,503 可稍后重试。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| effective_from | string · date-time | 是 | 实际生效的查询起始时间 | - |
| effective_to | string · date-time | 是 | 实际生效的查询结束时间 | - |
| items | array<object> | 是 | 结果列表;无结果时为空数组 | - |
| page | integer · int64 | 是 | 页码,从 1 开始 | - |
| page_size | integer · int64 | 是 | 每页条数 | - |
| total | integer · int64 | 是 | 符合筛选条件的总条数 | - |
items[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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" |
| source_ip | string | 是 | 来源 IP |
| user_email_snapshot | string | null | 是 | 事件发生时的邮箱快照;可为 null |
| user_id | string · uuid | 是 | 用户 ID |
| user_name_snapshot | string | 是 | 事件发生时的用户姓名快照 |