feat: deliver authenticated task APIs, SDK and P1 regression
This commit is contained in:
@@ -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)。
|
||||
|
||||
## 每个正式接口的文档模板
|
||||
|
||||
|
||||
Reference in New Issue
Block a user