GET/v1/jobs/stream
以流的形式获取作业变更（SSE）
jobs_stream
Server-Sent Events：先发送当前批次的快照，然后发送组织作业的变更（阶段、百分比、文件名）。
每个事件都有 id，它是一个时间戳游标。重新连接时，浏览器会在 Last-Event-ID 中发送它（或由客户端传入 ?since=），快照会补充连接中断期间发生的所有变更。
数据源的运行还可能产生不带 ID 游标的 {"type": "source", "source": {"id", "status", "updated_at"}} 事件。status 是正在进行的同步所处的阶段（listing、syncing、retry）或同步结果（ok、partial、error）。下载的文件由作业建立索引，并与上传的文件一样以 job 事件的形式到达。
身份验证
在 Authorization 请求头中传入 API 密钥：Authorization: Bearer <密钥>。
查询参数
sincestring | null恢复游标（带时区的 ISO 时间），可替代
Last-Event-ID。
请求头参数
X-View-Asstring仅适用于具有
admin角色的 API 密钥。以数据权限档案<profile>[:viewer|verifier|editor]的身份发出请求，例如employee:viewer。部署密钥不能使用此头（403）。Last-Event-IDstring | null最后收到的事件的 ID（EventSource 重新连接时使用）。流从它之后的事件开始。
Cookie 参数
kb_view_asstring会话的“View as”模式 Cookie。
POST /auth/view-as设置该 Cookie，DELETE /auth/view-as将其清除。
响应
200`text/event-stream`。第一个字段是 `retry: 3000`，接着是包含当前作业和摘要的 `snapshot` 事件，之后是 `job` 事件（作业有变更）和 `summary` 事件（状态变化后的摘要）。每个事件都带有 `id:`，即时间戳游标（ISO）。重新连接时，浏览器会在 `Last-Event-ID` 中发送它（或由客户端在 `?since=` 中传入），快照会补充连接中断期间发生的所有变更（最多回溯 24 小时）。每静默 15 秒，服务器会发送一条 `: keep-alive` 注释。响应头：`Cache-Control: no-cache`、`X-Accel-Buffering: no`。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
401未发送凭据（既没有会话 Cookie，也没有 API 密钥），或未找到该密钥。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
403不允许执行该操作：角色权限不足、无权访问合集或卡片、请求在“View as”模式下执行，或组织已被暂停或删除（`detail` 为对象，包含 `code: org_suspended | org_deleted`）。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
422校验错误：请求体或参数不符合定义的结构（`detail` 为校验错误列表），或参数值超出范围（`detail` 为消息）。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
429请求过多（`api.rate_limited`）、组织每分钟、每天或每月的配额已用完（`api.quota_exceeded`；`error.details` 中包含 `quota`、`limit` 和 `reset_at`）、已达到组织的限额，或回答服务繁忙（`answers.engine_busy`）。请等待 `Retry-After` 头中给出的时间。
响应头
Retry-After重试请求前需要等待的秒数。
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
错误码
除所有请求通用的错误码外，此接口还可能在 error.code 中返回以下错误码。
速率限制
响应带有 RateLimit 和 RateLimit-Policy 头，以及旧版的 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 头。429 响应带有以秒为单位的 Retry-After：等待后重试。