Skip to main content

导出下线执行用户接口

导出指定下线任务的执行用户名单，支持先用 keyword 过滤再导出。

  • Scope: admin.v1.force-logout-tasks.read
  • 权限项: 强制下线任务读取
  • 权限类型: read
  • 接口: GET/api/openapi/v1/force-logout-tasks/{taskId}/execution-users/export
使用 Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围（subject_scope={"mode":"all"}）；受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权，互不隐含。组织及应用操作主体取自可信鉴权，不接受请求参数指定。 仅查询已执行任务及持久化目标用户快照。executed 表示下线命令已生成，不代表客户端已经收到或完成下线。

请求参数

名称位置类型必填说明
taskIdpathstringTrue下线任务标识
keywordquerystringFalse搜索关键词

请求示例

curl --request GET 'https://example.invalid/api/openapi/v1/force-logout-tasks/11111111-1111-4111-8111-111111111111/execution-users/export' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

返回文件内容，通过 Content-Type 和 Content-Disposition 标识格式与下载文件名。

错误处理

沿用 {error, detail, code} 错误结构。身份校验失败为 401/403；缺少 Scope 或非全部用户范围为 403；资源不存在为 404；冲突或旧版本为 409；参数不合法为 400/422；依赖不可用为 503。业务错误沿用控制台语义。

接口语义与安全边界

仅支持已执行任务；导出前可能按现有逻辑补齐并持久化历史缺失用户快照，随后完成导出审计。补齐内容不保证等于执行时目录信息；导出是目标用户快照，不是客户端实际下线记录。CSV 对公式风险字段增加制表符前缀并引用转义，数据库/JSON 原值不变；程序读取须识别该展示前缀，不保证经其他软件转换或再次保存后仍安全。