Skip to main content

搜索管理员日志

使用 Authorization: Bearer <API_KEY>。各 Scope 独立授权。响应不应缓存。

使用 Authorization: Bearer <API_KEY>。各 Scope 独立授权。响应不应缓存。与管理员日志 UI 使用同一查询服务和 Console 查询模式:按时区限制为最多 7 个自然日,支持 q、重复 action_codes、category、result、range、timezone、from/to 与分页。page_size 为 10/20/50/100。响应包含 effective_from/effective_to。已有 GET /audit-logs 的游标拉取接口不变。本接口仅查询管理员日志;用户日志与 AI 日志分别使用 /user-logs 与 /ai-logs 及各自独立的敏感读取 Scope。

所需权限

所需权限资源Scope资源服务
管理员日志读取(read)audit-logsadmin.v1.audit-logs.readqwenwork-biz-service
GET /api/openapi/v1/audit-logs/search

公共请求头

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

请求参数

名称位置类型必填说明示例
qquerystring否搜索关键词; maxLength=200-
action_codesqueryarray<string> | null否操作代码列表-
categoryquerystring否分类名称; maxLength=64-
resultquerystring否result; enum=["success", "failure", "partial_success"] 取值:"failure"、"partial_success"、"success"-
rangequerystring否range; enum=["last7"], default="last7" default="last7" 取值:"last7"-
timezonequerystring否时区; maxLength=128-
fromquerystring · date-time否时间范围起点; format="date-time"-
toquerystring · date-time否时间范围终点; format="date-time"-
pagequeryinteger · int64否页码,从 1 开始; format="int64", minimum=1, default=1 default=1-
page_sizequeryinteger · int64否每页条数; format="int64", enum=[10, 20, 50, 100], default=20 default=20 取值:10、100、20、50-

请求示例

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

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取响应结果。
default未单独列出的认证、授权、校验或依赖错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态与 code 处理;写操作重试前核实结果及幂等要求。

响应结果

Content-Type: application/json
名称类型必填说明示例
effective_fromstring · date-time是生效开始时间; format="date-time"-
effective_tostring · date-time是生效结束时间; format="date-time"-
itemsarray<object> | null是结果列表-
pageinteger · int64是页码,从 1 开始; format="int64"-
page_sizeinteger · int64是每页条数; format="int64"-
totalinteger · int64是符合筛选条件的总记录数; format="int64"-

items[]

字段类型必填说明
action_codestring是操作
actor_email_snapshotstring否操作人邮箱(操作时快照)
actor_name_snapshotstring否操作人姓名(操作时快照)
actor_qid_snapshotstring是操作人 QID(操作时快照)
actor_user_idstring是操作人 ID
after_displaystring | null是变更后内容
before_displaystring | null是变更前内容
categorystring是日志分类
detail_attributesobject是详情属性
detail_codestring否详情代码
detail_textstring否操作详情
event_idstring是事件 ID
occurred_atstring · date-time是操作时间; format="date-time"
resource_idstring否资源 ID
resource_labelstring否操作对象
resource_typestring是资源类型
resultstring是操作结果
sourcestring是来源
source_ipstring否来源 IP
success_countinteger · int64否成功数量; format="int64"
target_countinteger · int64否目标用户数; format="int64"
trace_idstring否链路追踪 ID

错误与重试

保留现有 UI 服务的错误码与校验。401/403 表示认证或授权失败;409 表示冲突,应重新读取后重试;413 表示请求过大;400/422 表示参数校验失败;503 表示依赖不可用。 以实际响应及机器契约为准。创建类幂等操作重试应使用相同 Idempotency-Key 与相同请求。