轮询批量作业的状态与计数器,读取按目标的结果,并下载结果文件。在你提交批量操作之后,接着调用两个查询:用于作业状态与汇总计数的
getBulkOperationJob,以及用于每个目标明细的 getBulkOperationItems。完成状态仅支持轮询——没有批量 webhook。
目前仅在
staging 可用。要求
Authorization: Basic <API_KEY>- 你的应用已启用批量 API 能力。
- 作业必须属于你的应用——未知或其他应用的作业 id 将返回未找到。
查询 — 作业状态
轮询直到status 进入终态(COMPLETED、COMPLETED_WITH_ERRORS、FAILED 或 CANCELLED)。
查询 — 按目标结果
基于游标的分页(每页 100)并可按条目状态过滤——过滤到FAILED 以仅对失败进行对账,或读取 resultResourceId 将成功写入映射回其产生的 Fluz 资源。
下载结果文件
选择resultUrl 会按需生成一个短时(约 15 分钟)签名下载 URL——仅轮询状态而不请求该字段的成本较低。打开它(或使用 curl -L)即可下载一个NDJSON文件,每个目标一行。
- 导出(
GET_*_EXPORT)——导出的余额/交易记录。 - 写入(
CREATE_TRANSFER、DEPOSIT_CASH_BALANCE)——一份结果分类账:每个目标包含{ externalReferenceId, accountId, status, resultResourceId, resourceType, errorCode, errorMessage }。
resultUrl 为 null。一旦链接过期(resultUrlExpiresAt),再次请求该字段以获取新的 URL。
参数
响应字段
getBulkOperationItems 与结果文件是相同逐条目数据的两种视图。使用 items 查询进行程序化对账(过滤到 FAILED、映射 resultResourceId);对于大型作业,使用结果文件一次性拉取完整分类账。错误
这些查询仅在请求本身失败时整体失败——错误的目标永远不是请求错误,而是逐条目的FAILED/SKIPPED 结果(见下文)。
逐条目失败代码
FAILED 或 SKIPPED 的条目会携带机器可读的 errorCode 与面向人的 errorMessage。SKIPPED 代码在提交时分配(目标从未进入队列);FAILED 代码可能来自提交时校验,或对已接受条目在执行时由下游服务返回。
任意操作:
仅
CREATE_TRANSFER:
仅
DEPOSIT_CASH_BALANCE:
带有类别前缀的代码由 Fluz 指定;downstream 行表示条目直接携带执行服务自身的错误代码,因此这些代码是开放集合。请针对你已处理的代码进行编程,未知代码按通用失败处理——读取
errorMessage 获取可读原因。