Skip to main content

导出用户日志接口

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

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。业务字段、筛选和返回结构与控制台一致。查询及导出最多七个自然日;用户日志 VPC 保留 90 天、K8S 保留 180 天,AI 日志保留 90 天。时间窗口由服务端按保留期截断,返回 effective_from/effective_to。CSV 最多 10,000 行,使用 locale 选择语言;导出不会返回列表的分页或 effective_from/effective_to 字段。审计提交失败时不释放文件内容。Content-Disposition 指定下载文件名。

所需权限

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

公共请求头

适用《通过 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 筛选-
timezonequerystring否IANA 时区;省略时使用 UTC; maxLength=64-
localequerystring否CSV 内容语言;省略时使用简体中文(zh-CN),不读取控制台用户语言; 取值:"zh-CN"、"zh-TW"、"en"-

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl '<BASE_URL>/api/openapi/v1/user-logs/export' \
  --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: text/csv
名称类型必填说明示例
$bodystring · binary是完整 CSV 文件内容;$body 表示正文,不是 JSON 字段。-