Skip to main content

查询用户日志接口

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

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。业务字段、筛选和返回结构与控制台一致。查询及导出最多七个自然日;用户日志 VPC 保留 90 天、K8S 保留 180 天,AI 日志保留 90 天。时间窗口由服务端按保留期截断,返回 effective_from/effective_to。

所需权限

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

公共请求头

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

请求参数

名称位置类型必填说明示例
user_namequerystring否用户姓名筛选; maxLength=200-
auxiliary_identifierquerystring否辅助标识类型;与辅助标识值配合使用; maxLength=200-
auxiliary_valuequerystring否辅助标识值;提供时必须指定 EMAIL、PHONE、EMPLOYEE_NO 或 ACCOUNT 类型; maxLength=200-
actionquerystring否操作类型; maxLength=200-
descriptionquerystring否操作描述筛选; maxLength=200-
source_ipquerystring否来源 IP; maxLength=200-
qquerystring否搜索关键词; maxLength=200-
resultquerystring否执行结果; 取值:"success"、"failure"-
rangequerystring否默认查询最近七个自然日;提供 from/to 时忽略此项; default="last7"; 取值:"last7"-
fromquerystring · date-time否起始时间;必须与 to 一起提供,最多七个自然日-
toquerystring · date-time否结束时间;必须晚于 from;窗口按 UI 保留期截断-
department_idquerystring · uuid否部门 ID 筛选-
pagequeryinteger · int64否页码,从 1 开始; minimum=1; default=1-
page_sizequeryinteger · int64否每页条数; default=20; 取值:10、20、50、100-
timezonequerystring否IANA 时区;省略时使用 UTC; maxLength=64-

请求示例

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

响应状态表

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_fromstring · date-time是实际生效的查询起始时间-
effective_tostring · date-time是实际生效的查询结束时间-
itemsarray<object>是结果列表;无结果时为空数组-
pageinteger · int64是页码,从 1 开始-
page_sizeinteger · int64是每页条数-
totalinteger · int64是符合筛选条件的总条数-

items[]

字段类型必填说明
event_descriptionstring是事件描述
event_idstring · uuid是事件 ID
event_timestring · date-time是事件发生时间
event_typestring是事件类型;用户日志为操作事件类型,AI 日志为 ai.turn; pattern="^[a-z][a-z0-9_]+$"
resultstring是执行结果; 取值:"success"、"failure"
source_ipstring是来源 IP
user_email_snapshotstring | null是事件发生时的邮箱快照;可为 null
user_idstring · uuid是用户 ID
user_name_snapshotstring是事件发生时的用户姓名快照

响应示例

{
  "items": [
    {
      "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"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20,
  "effective_from": "2026-10-26T00:00:00Z",
  "effective_to": "2026-10-26T08:30:00Z"
}