Skip to main content

查询下线执行用户接口

分页查询指定下线任务实际执行到的用户,taskId 指定任务,keyword 按用户信息模糊搜索。

  • Scope: admin.v1.force-logout-tasks.read
  • 权限项: 强制下线任务读取
  • 权限类型: read
  • 接口: GET/api/openapi/v1/force-logout-tasks/{taskId}/execution-users
使用 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' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

名称类型说明
itemsarray结果列表
items[].departmentsarray用户部门快照
items[].departments[].idstring记录标识
items[].departments[].namestring名称
items[].departments[].pathstringpath
items[].emailstring用户邮箱
items[].employee_nostring员工编号
items[].user_idstring设备所属用户标识
items[].user_namestring用户姓名
pageinteger页码,从 1 开始
page_sizeinteger每页条数,最多 100
totalinteger总记录数

错误处理

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

接口语义与安全边界

仅支持已执行任务。查询历史任务时,现有服务会按需补齐缺失的用户快照并写回数据库,因此并非完全无写入;补齐字段反映补齐时可获取的目录信息,不应视作精确的执行时历史。结果为任务目标用户,不是已完成下线的客户端清单;包含姓名、邮箱、工号和部门。