Skip to main content
轮询批量作业的状态与计数器,读取按目标的结果,并下载结果文件。
在你提交批量操作之后,接着调用两个查询:用于作业状态与汇总计数的 getBulkOperationJob,以及用于每个目标明细的 getBulkOperationItems。完成状态仅支持轮询——没有批量 webhook。
目前仅在 staging 可用。

要求

  • 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 获取可读原因。