docs: wordcloud 契约补充生产订单列表（GET /api/orders）

2026-08-13 12:16:33 +08:00
parent 6552b15d2e
commit c28b2af651
1 changed files with 4 additions and 0 deletions
@@ -131,4 +131,8 @@ wordcloud 项目内部仍在大量变更，但只要不违反本文档，`wxmp_b
 - 结果图由 wxmp_backend 下载并转存 COS，返回给小程序的是 COS 公网 URL。
 - `WORDCLOUD_API_URL` 未配置时，下单派单返回结构化“未配置”错误（状态字面量
  `not_configured`，见 `api-contract-v1.md` §8 的 `POST /api/orders/:id/dispatch`），不做假成功。
+- **生产订单列表（wordcloud 侧运营查看，raw 消费可选）**：wordcloud 在 `POST /api/jobs`
+  WCD 模式下从 `manifest.meta.orderNo` 登记生产订单，暴露 `GET /api/orders` 与
+  `GET /api/orders/{order_no}`。`wxmp_backend` 不消费该接口，仅供 wordcloud/运营侧查看
+  下单投递的生产任务与状态；`job_id → orderNo` 仍以 `wxmp_backend` 侧 `CustomizationTask` 为准。
 - wordcloud 若对外暴露公网，需要加访问 token 或网络白名单，防止被直接刷任务。