Markify API
Markify API 是唯一业务入口，负责协议校验、资源代理、预览流和最终渲染编排，不执行图片像素处理，也不持有上传原文件。
职责
- 将公开上传流式转发给 Resource Service。
- 维护一个资源至一个活动预览流的唯一映射。
- 校验公开
version: 1批量任务。 - 拆分多源任务并调用 Image Worker v2。
- 原子发布实时预览帧。
- 锁定资源、限制最终渲染并发并流式生成 ZIP。
- 在交付完成后消费源资源，失败时回滚。
- 提供健康、依赖检查、日志查询和 Web 控制台。
公开端点
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /health/live | 存活检查 |
GET | /health/ready | 就绪检查 |
GET | /health/dependencies | Worker 聚合状态 |
POST | /v1/resource | 上传临时图片 |
DELETE | /v1/resource/{resourceToken} | 删除资源并关闭流 |
POST | /v1/source/streams | 创建或复用预览流 |
GET | /v1/source/stream/{streamToken} | 订阅实时预览 |
DELETE | /v1/source/streams/{streamToken} | 关闭预览流 |
POST | /v1/source/preview | 生成并发布预览 |
POST | /v1/source/render | 生成最终 ZIP |
POST | /v1/render/image | 旧 multipart 兼容接口 |
GET | /logs | 查询 API 结构化日志 |
必需下游
- 上传和图片双通道必须访问 Resource Service。
- 图片预览和渲染必须在
WORKER_ENDPOINTS中配置image。 - Video Worker 缺失不会影响当前图片链路。
进程状态
预览映射和最新帧在进程内保存，受 MAX_PREVIEW_STREAMS 和 PREVIEW_FRAME_CAPACITY_BYTES 限制。API 重启后旧 streamToken 失效，但仍然存在的资源可以重新创建流。