Skip to main content
轮询批量作业的状态与计数,读取每个目标的结果,并下载结果文件。
在你提交批量操作之后,继续发起两个查询:用于作业状态与汇总计数的 getBulkOperationJob,以及用于逐目标详情的 getBulkOperationItems。完成检测仅支持轮询——没有批量 Webhook。

要求

  • Authorization: Basic <API_KEY>
  • 你的应用已启用批量 API 能力。
  • 作业必须属于你的应用——未知或属于其他应用的作业 id 会返回未找到。

查询 — 作业状态

轮询该查询直至 status 达到终态(COMPLETEDCOMPLETED_WITH_ERRORSFAILEDCANCELLED)。

查询 — 逐目标结果

支持游标分页(每页 100 条)并可按条目状态过滤——例如过滤为 FAILED 以仅对失败项进行对账,或读取 resultResourceId 将成功写入映射回其产生的 Fluz 资源。

下载结果文件

选择 resultUrl 会即时生成一个短期(约 15 分钟)有效的签名下载 URL——只轮询状态而不请求该字段的成本很低。打开它(或使用 curl -L)下载一个NDJSON 文件,每个目标一行。
  • 导出GET_*_EXPORT)——导出的余额/交易。
  • 写入CREATE_TRANSFERDEPOSIT_CASH_BALANCE)——结果分类账:每个目标一条 { externalReferenceId, accountId, status, resultResourceId, resourceType, errorCode, errorMessage }
在作业达到终态之前,以及对未产出文件的作业,resultUrlnull。当链接过期时(resultUrlExpiresAt),再次请求该字段以获取新的 URL。

参数

响应字段

getBulkOperationItems 与结果文件是同一批逐条数据的两种视图。使用 items 查询进行程序化对账(过滤为 FAILED,映射 resultResourceId);对于大型作业,使用结果文件一次性拉取完整分类账。

错误

这些查询仅在请求本身有问题时才会整体失败——错误的目标绝不会是请求错误,而是逐条的 FAILED/SKIPPED 结果(见下方)。

单条失败代码

FAILEDSKIPPED 的条目会携带机器可读的 errorCode 与面向人的 errorMessageSKIPPED 代码在提交时分配(目标从未进入队列);FAILED 代码可能来自提交时校验,或对于已被接受的条目,来自执行时的下游服务。 适用于任意操作: 仅适用于 CREATE_TRANSFER 仅适用于 DEPOSIT_CASH_BALANCE
带前缀类别的代码为 Fluz 指派;downstream 行表示条目会原样携带执行服务自身的错误代码,因此这些代码是开放集合。仅对你已处理的代码进行编程,未知代码视为通用失败——请读取 errorMessage 获取人类可读原因。