feat: establish Orbit models, migrations and development baseline
This commit is contained in:
16
docs/api/tasks.md
Normal file
16
docs/api/tasks.md
Normal file
@@ -0,0 +1,16 @@
|
||||
# 任务接口规划
|
||||
|
||||
状态:计划 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 请求体。接口实现后同步增加完整请求/响应、错误码及文件转换场景。
|
||||
Reference in New Issue
Block a user