轮询已复核文档

说明外部 worker 如何轮询已在 Numora 中复核完成、可进入下游交付流程的文档。

适用范围

本页说明外部 worker（例如 n8n）应如何轮询 Numora 中已经完成复核、可进入下游交付的文档。

适用于以下场景：

文档已经在 Numora 内完成处理与复核
外部 worker 需要一个稳定的轮询读取口
只有复核完成后才允许进入下游交付

完整的 outbox -> dispatch 集成模式见 n8n 出站交付。

为什么推荐轮询 Outbox

相比自行扫描所有 documents，轮询 delivery/outbox 更安全，因为该接口已经应用了交付语义的过滤条件。

当前模型会排除已经处于以下状态的文档：

push_pending
push_succeeded

因此，worker 可以只关注仍待交付的 reviewed documents。

请求示例

curl "https://api.numora.example/v1/delivery/outbox?provider=dynamics365&limit=100" \
  -H "Authorization: Bearer $NUMORA_API_KEY" \
  -H "x-request-id: reviewed-poll-001"

响应示例

{
  "data": [
    {
      "document_id": "4be38121-3791-4856-80d5-c57dbec2cf78",
      "schema": "invoice_v2",
      "status": "reviewed",
      "external_id": null,
      "metadata": {},
      "result_url": "/v1/documents/4be38121-3791-4856-80d5-c57dbec2cf78/result",
      "dispatch_url": "/v1/documents/4be38121-3791-4856-80d5-c57dbec2cf78/dispatch",
      "updated_at": "2026-03-24T02:36:37.684Z"
    }
  ],
  "meta": {
    "provider": "dynamics365",
    "next_cursor": null
  }
}