Primeros Pasos

Esta guia crea un scheduler, encola una tarea retrasada, lista tareas, reserva con lease y consulta health.

Crear Scheduler

1curl -X POST "https://api.hola.cloud/schedulers" \
2  -H "X-API-Key: TU_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
6    "display_name": "mi-scheduler"
7  }'

1{
2  "scheduler": {
3    "id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
4    "ready": true,
5    "scheduled": 0,
6    "inflight": 0,
7    "display_name": "mi-scheduler"
8  }
9}

Encolar Tarea

1curl -X POST "https://api.hola.cloud/schedulers/sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks" \
2  -H "X-API-Key: TU_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "id": "tarea-001",
6    "payload": { "type": "enviar_correo" },
7    "delay": "60s",
8    "labels": ["proyecto:incorporacion", "prioridad:alta"]
9  }'

Respuesta: HTTP 202 Accepted con cuerpo vacio.

Listar Tareas

 1{
 2  "scheduled": [
 3    {
 4      "id": "tarea-001",
 5      "future": "2025-06-21T12:01:01Z",
 6      "labels": ["proyecto:incorporacion", "prioridad:alta"]
 7    }
 8  ],
 9  "inflight": [],
10  "scheduled_meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 },
11  "inflight_meta": { "page": 1, "per_page": 25, "total": 0, "total_pages": 0 }
12}

Reservar y Confirmar

1{ "worktime": "30s" }

1{
2  "id": "tarea-001",
3  "payload": { "type": "enviar_correo" },
4  "lease_expires_at": "2025-06-21T12:02:01Z",
5  "labels": ["proyecto:incorporacion", "prioridad:alta"]
6}

Para confirmar, elimina la tarea. La respuesta es HTTP 204 No Content.

Health

1{
2  "status": "ok",
3  "ready": true,
4  "scheduled": 0,
5  "inflight": 0,
6  "scheduler_id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
7}