Job Hub API

接口说明

所有 job 状态都存储在 Durable Object 中。接口默认返回 JSON。

PUT/api/jobs/:jobId

创建或更新 job

设置某个 job 的名称、描述、完成百分比、状态和扩展信息。字段都是可选的，未传字段会保留旧值。

curl -X PUT https://job-hub.kokoship.com/api/jobs/demo-job \
  -H 'content-type: application/json' \
  -d '{"name":"Demo Job","description":"正在处理数据","progress":42,"status":"running","metadata":{"stage":"rendering","externalTaskId":"task_123"}}'

GET/api/jobs/:jobId

获取单个 job

返回指定 job 的完整信息。

curl https://job-hub.kokoship.com/api/jobs/demo-job

GET/api/jobs

获取 job 列表

返回当前全部 job，按更新时间倒序排列。首页就是每秒请求这个接口刷新列表。

curl https://job-hub.kokoship.com/api/jobs

DELETE/api/jobs/:jobId

删除 job

从 Durable Object storage 中删除指定 job。

curl -X DELETE https://job-hub.kokoship.com/api/jobs/demo-job

字段说明

字段	类型	说明
jobId	string	路径参数，job 唯一标识
name	string	job 名称
description	string	job 描述
progress	number	完成百分比，自动限制在 0-100
status	running \| completed \| failed	job 当前状态
metadata	object	任意阶段的扩展信息，传入时整体替换旧值
createdAt	string	创建时间，ISO 字符串
updatedAt	string	更新时间，ISO 字符串