diff --git a/docs/wordcloud-contract.md b/docs/wordcloud-contract.md index 646a8bc..b65ed3e 100644 --- a/docs/wordcloud-contract.md +++ b/docs/wordcloud-contract.md @@ -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 或网络白名单,防止被直接刷任务。 \ No newline at end of file