Ver las próximas ejecuciones cron

El momento antes de publicar un horario que importa

Existe un tipo específico de ansiedad al subir un nuevo horario cron a producción: ¿0 0 1 * * realmente se ejecutará a medianoche el primero de mes, o un error de tipeo acaba de crear una tarea que se dispara cada minuto? Ingenieros de plataforma lanzando una nueva tarea programada, equipos de control de calidad validando una función de programación antes del lanzamiento, y cualquiera que investigue por qué una tarea corrió dos veces ayer necesitan lo mismo: una lista concreta de marcas de tiempo en vez de una simulación mental de la sintaxis. Que una expresión equivocada llegue silenciosamente a producción, una que se dispare demasiado seguido o nunca, es el tipo de error barato de detectar antes y costoso de detectar en una revisión de incidente.

Qué devuelve la solicitud

POST /dev/cron-next acepta una expresión cron, un momento de referencia inicial y el número de próximas ocurrencias a calcular, y devuelve esa lista exacta de marcas de tiempo de ejecuciones futuras. La tarea se pone en cola de forma asíncrona y devuelve un task_id de inmediato; la lista de horarios de ejecución llega poco después por webhook firmado o por un enlace firmado válido por 24 horas, lista para mostrarse en un panel de vista previa o compararse contra los valores esperados en una prueba.

Por qué calcular la 'siguiente' ejecución no es trivial

Calcular la próxima ocurrencia de una expresión cron suena a aritmética simple hasta que entran en juego los casos límite de fin de mes, como un horario fijado para el día 31 en un mes de 30 días, la interacción entre los campos de día de la semana y día del mes de una forma que el estándar cron deja ambigua, y los valores de paso combinados con rangos. El formato en sí data de la programación Unix de los años setenta, mucho antes de que nadie imaginara que sería analizado y previsualizado por APIs web, razón por la cual vale la pena sacar un cálculo de próxima ejecución dedicado y bien probado del código de aplicación en vez de reimplementarlo cada vez.

Cómo encaja en un flujo de pruebas o despliegue

Este endpoint se presta naturalmente a verificaciones de integración continua, calculando las próximas ejecuciones de cada tarea programada en un despliegue y marcando cualquiera que no coincida con la frecuencia esperada antes de que el cambio salga, y a paneles de administración que muestran 'esta tarea se ejecutará próximamente en estos cinco momentos' en cuanto alguien escribe una expresión. Combina directamente con un endpoint de explicación cron: mostrar qué significa el horario en palabras y luego mostrar exactamente cuándo se dispara. A $0.002 por solicitud, validar cada tarea programada en un pipeline de despliegue se mantiene económico.

Acceso y estado actual

Usar el endpoint requiere saldo prepago; sin saldo, las solicitudes devuelven HTTP 402 en vez de una lista adivinada o incompleta. El precio es un plano $0.002 por solicitud sin importar cuántas ocurrencias se pidan. El endpoint está activo ahora, y las expresiones enviadas para el cálculo se descartan después de la ventana de entrega, nunca se usan para entrenamiento.