预留任务

预留一个可用的任务进行处理。任务进入由 worktime 定义的租约期。

身份验证

需要身份验证。通过 X-API-Key 或 Authorization: Bearer 头部传递 API 密钥。

路径参数

请求体

1{
2  "worktime": "30s"
3}

请求示例

1curl -X POST "https://api.hola.cloud/schedulers/sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks/reserve" \
2  -H "X-API-Key: YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "worktime": "30s"
6  }'

响应示例

1HTTP/1.1 200 OK
2Content-Type: application/json

1{
2  "id": "task-x1y2z3",
3  "payload": {
4    "type": "send_email",
5    "to": "user@example.com",
6    "template": "welcome"
7  },
8  "lease_expires_at": "2025-06-21T12:02:01Z"
9}

错误代码