feat: deliver authenticated task APIs, SDK and P1 regression

This commit is contained in:
2026-09-17 07:41:32 +08:00
parent 4f2935e36f
commit 9701b7a071
37 changed files with 3169 additions and 67 deletions

View File

@@ -8,17 +8,19 @@
| --- | --- | --- |
| `GET /health/live` | 已实现 | [健康检查](health.md) |
| `GET /health/ready` | 已实现,仅验证数据库与迁移记录 | [健康检查](health.md) |
| `/v1/tasks` 与任务管理 | 计划 P1–P3,尚未实现 | [任务接口规划](tasks.md) |
| `/v1/tasks` 提交、查询、分页与待执行取消 | P1 已实现 | [任务接口](tasks.md) |
| `/v1/queues` 创建与查询 | P1 已实现 | [队列接口](queues.md) |
| 凭据校验与初始化 CLI | P1 已实现 | [鉴权](authentication.md) |
| `/v1/worker/connect` | 计划 P2,尚未实现 | [协议草案](../03-http-websocket-protocol.md) |
| `/v1/schedules` 与计划管理 | 计划 P3,尚未实现 | [协议草案](../03-http-websocket-protocol.md) |
| `/v1/events/connect` | 计划 P3,尚未实现 | [协议草案](../03-http-websocket-protocol.md) |
| `/v1/workflows` 与流程管理 | 计划 P4–P5,尚未实现 | [流程接口规划](workflows.md) |
当前服务对未实现路由返回 404。健康检查就绪不表示任务调度、鉴权或流程引擎已经可用。
未实现路由返回 404。健康检查就绪不表示任务执行、定时调度或流程引擎已经可用。
## 业务接口统一要求
下述业务契约尚在实现阶段细化,不能用于声称当前已有业务 API:
P1 业务接口已遵守下述约定,后续接口继续沿用:
- 生产使用 HTTPS/WSS,凭据通过授权头或受控握手传递,不放入 URL。
- 应用身份、命名空间和操作权限分别校验;知道资源 ID 不等于拥有权限。
@@ -27,7 +29,7 @@
- 时间为 UTC RFC 3339,时长字段带单位;查询和批量操作有上限。
- 错误码、字段、分页游标和限制值在对应阶段实现及回归后冻结。
健康接口目前直接返回状态对象。业务接口计划使用 `request_id` + `data` / `error` 信封,详见 [通信协议](../03-http-websocket-protocol.md)。
健康接口直接返回状态对象。已实现的业务接口使用 `request_id` + `data` / `error` 信封;当前实际字段以本目录手册为准,其他尚未实现的接口见 [通信协议草案](../03-http-websocket-protocol.md)。
## 每个正式接口的文档模板