历史归档

历史方案:轮询已复核文档

已移除的 delivery outbox 轮询模式的历史说明。当前请改用 route-based dispatch 或 n8n webhook 交付。

当前状态

本页仅作为历史参考保留。

GET /v1/delivery/outbox 已不再属于当前推荐的 Numora 集成模型。

如果你正在开始新集成,请跳过本页,直接阅读 n8n 出站交付交付状态回执

当前正式路径已收敛为:

  • workflow:由 Numora 内建执行
  • n8n executor + webhook notify:由共享 n8n 编排执行

现在应该怎么做

1. 使用 route-based dispatch

对于已复核且已 finalized 的文档,调用:

  • POST /v1/documents/{id}/dispatch

Numora 会先解析当前激活的 delivery route,然后:

  • 分发到配置好的 workflow,或
  • 入队 n8n webhook delivery,并通知共享执行器

2. 使用交付状态回执

如果真正的下游写入发生在 Numora 之外,请在完成后调用:

  • POST /v1/documents/{id}/delivery

3. 用文档状态看结果

GET /v1/documents/{id} 作为主要状态面:

  • reviewed
  • push_pending
  • push_succeeded
  • push_failed

迁移建议

如果你仍有任何 worker 在轮询 /v1/delivery/outbox,建议迁移到当前 route-based 模型:

  1. 先在 Numora 内配置正式 delivery route。
  2. dispatch 启动下游交付。
  3. 当激活路径为 n8n executor 时,让 Numora 去通知共享 n8n webhook。
  4. 只有当真正写入在 Numora 之外执行时,才调用 delivery callback。

当前应阅读的页面