Encolar Tarea
Encola una nueva tarea para ejecutarse en un horario programado.
Autenticación
Requiere autenticación. Pasa tu clave API mediante el encabezado X-API-Key o Authorization: Bearer.
Parámetros de Ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | string | Identificador único del scheduler |
Cuerpo de la Solicitud
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | ID de tarea requerido |
| future | string | Marca de tiempo ISO 8601 para la disponibilidad |
| delay | string | Duración Go desde ahora, como 60s o 5m (alternativa a future) |
| payload | object | Carga útil JSON arbitraria para el trabajador |
| labels | array de strings | Etiquetas opcionales para filtrado |
1{
2 "payload": {
3 "type": "enviar_correo",
4 "to": "usuario@example.com",
5 "template": "bienvenida"
6 },
7 "delay": "60s",
8 "labels": ["proyecto:incorporacion", "prioridad:alta"]
9}
Ejemplo de Solicitud
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 "payload": {
6 "type": "enviar_correo",
7 "to": "usuario@example.com",
8 "template": "bienvenida"
9 },
10 "delay": "60s",
11 "labels": ["proyecto:incorporacion", "prioridad:alta"]
12 }'
Ejemplo de Respuesta
1HTTP/1.1 202 Accepted
El cuerpo de la respuesta está vacío.
Códigos de Error
| Estado | Código | Descripción |
|---|---|---|
| 400 | invalid_json | JSON inválido |
| 400 | validation_error | Falta id, future/delay inválido o labels inválidas |
| 401 | unauthorized | Clave API faltante o inválida |
| 409 | task_already_exists | La tarea ya existe |
| 500 | internal_error | Error interno del servidor |
Comentarios