1.2 KiB
1.2 KiB
任务接口规划
状态:计划 P1–P3,尚未实现。以下为后续落地清单;实际字段与可运行请求将在相应阶段补齐。
| 操作 | 候选接口 | 关键行为 |
|---|---|---|
| 提交 | POST /v1/tasks |
携带稳定 Idempotency-Key,受理提交完成后响应 |
| 批量提交 | POST /v1/tasks:batchSubmit |
每项独立幂等与结果;顶层成功不代表全部成功 |
| 查询 | GET /v1/tasks/{task_id} |
校验命名空间和权限,返回当前状态与结果 |
| 执行历史 | GET /v1/tasks/{task_id}/attempts |
分页返回历史尝试,不展示执行秘密凭据 |
| 取消 | POST /v1/tasks/{task_id}:cancel |
待执行时取消生效;在途工作先记录取消意图 |
| 人工重试 | POST /v1/tasks/{task_id}:retry |
带原因与权限;流程关联任务通过 Weave 恢复 |
提交契约需要队列、处理器/参数版本、业务输入或引用、执行时间、时限、恢复安全等级和重试策略。业务参数内容由接入方解释。
P1 回归完成前,此页不提供看似可调用的 SDK 方法或 HTTP 请求体。接口实现后同步增加完整请求/响应、错误码及文件转换场景。