Files
orbit/docs/api/tasks.md

1.2 KiB
Raw Blame History

任务接口规划

状态:计划 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 请求体。接口实现后同步增加完整请求/响应、错误码及文件转换场景。