轮询批量作业的状态与计数,读取每个目标的结果,并下载结果文件。在你提交批量操作之后,继续发起两个查询:用于作业状态与汇总计数的
getBulkOperationJob,以及用于逐目标详情的 getBulkOperationItems。完成检测仅支持轮询——没有批量 Webhook。
要求
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 获取人类可读原因。