历史归档
历史方案:轮询已复核文档
已移除的 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,或
- 入队
n8nwebhook delivery,并通知共享执行器
2. 使用交付状态回执
如果真正的下游写入发生在 Numora 之外,请在完成后调用:
POST /v1/documents/{id}/delivery
3. 用文档状态看结果
以 GET /v1/documents/{id} 作为主要状态面:
reviewedpush_pendingpush_succeededpush_failed
迁移建议
如果你仍有任何 worker 在轮询 /v1/delivery/outbox,建议迁移到当前 route-based 模型:
- 先在 Numora 内配置正式 delivery route。
- 用
dispatch启动下游交付。 - 当激活路径为
n8n executor时,让 Numora 去通知共享n8nwebhook。 - 只有当真正写入在 Numora 之外执行时,才调用 delivery callback。