Cron jobs
Los Cron jobs ejecutan peticiones HTTP programadas que se repiten cada cierto tiempo. Son útiles para tres escenarios típicos:
- Renovar tokens de autenticación que tus herramientas de API REST usan mediante
periodicAuth. - Mantener caches calientes o disparar pings de salud a tus servicios.
- Ejecutar cargas periódicas o cualquier side-effect programado.
Cada corrida se registra con su request y su response, para que puedas auditar qué pasó en cada ejecución.
Para empezar, haz clic en "Crear cron job". El asistente cambia según el tipo que elijas: un cron de tipo auth tiene 6 pasos (incluye el paso Resultado), mientras que uno genérico tiene 5 pasos.
Paso 1: Configuración
Dale un nombre y un intervalo. El tipo decide cómo se usa el resultado de cada corrida.
| Tipo | Para qué sirve |
|---|---|
| Auth (renueva tokens) | Renueva periódicamente un token de autenticación y guarda el último valor para que tus herramientas lo usen vía periodicAuth. |
| Genérico (request programado) | Ejecuta una request HTTP programada y guarda la respuesta. Útil para mantener caches calientes, pings de salud o cargas periódicas. |
| Campo | Descripción |
|---|---|
| Nombre | Único en el workspace. Para crons de tipo auth, este es el nombre que tus herramientas referencian con periodicAuth.name. |
| Descripción | Una nota breve sobre qué hace el cron (opcional). |
| Intervalo (horas) | Cada cuántas horas se ejecuta. Entre 1 y 168 (una semana). El scheduler revisa cada 5 minutos. |
El tipo auth es justo el que conecta con la opción Auth periódica del apartado Avanzado de una API REST : ahí seleccionas este cron por su nombre para inyectar el token renovado en tus requests.
Paso 2: Request
Define la petición HTTP que ejecutará el cron: método, URL, headers, body y autenticación. Las path variables (:nombre) se detectan automáticamente.
Es el mismo constructor que usas en API REST, con las pestañas Params, Authorization, Headers, Body y Configuración.
Paso 3: Resultado (solo tipo auth)
Indica dónde está el token dentro del JSON que devuelve tu endpoint. Este paso solo aparece para crons de tipo auth.
| Campo | Descripción |
|---|---|
| Result path | El path al token usando notación punto. Por ejemplo: access_token, data.token o tokens[0].value. |
Tus herramientas y scripts inyectan este token con periodicAuth: { name: "...", key: "Authorization" }. El último valor extraído queda guardado en cron/{id}/results.
Paso 4: Cuándo
Define cuándo se permite ejecutar el cron. Por defecto corre según su intervalo, 24/7, sin tope.
Activa "Reglas de ejecución" si quieres limitarlo:
| Regla | Descripción |
|---|---|
| Zona horaria | La zona en la que se evalúan las reglas de días y horas (por ejemplo, UTC). |
| Días permitidos | Los días de la semana en los que puede ejecutarse. |
| Ventana horaria | Por defecto corre las 24 h de los días permitidos; activa "Restringir" para acotarlo a un rango de horas. |
| Límites de ejecución | Máx por día y Máx por mes para topar el número de corridas. El contador se reinicia al cambiar de día / mes en la zona horaria configurada. |
Paso 5: Probar
Antes de crear el cron, puedes ejecutar la request configurada y ver la respuesta en tiempo real contra tu endpoint. No se persiste nada todavía.
Haz la prueba siempre que puedas: es la forma más rápida de detectar una URL mal escrita o una autenticación incorrecta antes de que el cron empiece a correr solo.
Cuando estés conforme, haz clic en "Crear cron".
Paso 6: Listo
El cron queda creado. La primera ejecución ocurrirá dentro del intervalo configurado como máximo (por ejemplo, en máximo 12 h si ese es tu intervalo); si no quieres esperar, puedes correrlo manualmente desde el detalle.
Desde aquí puedes "Volver al listado" o ir a "Ver detalles" del cron recién creado.
Recuerda que un cron genérico tiene un paso menos (no incluye Resultado), por lo que para ese tipo Probar y Listo son los pasos 4 y 5.