Reservar Tarea

Reserva una tarea disponible para procesamiento. La tarea entra en un período de concesión definido por worktime.

Autenticación

Requiere autenticación. Pasa tu clave API mediante el encabezado X-API-Key o Authorization: Bearer.

Parámetros de Ruta

Cuerpo de la Solicitud

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

Ejemplo de Solicitud

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

Ejemplo de Respuesta

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

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

Códigos de Error