Aller au contenu
Accueil moxon

Parseur d'expressions cron

L'endpoint /cron analyse une expression cron à 5 champs et retourne une description lisible ainsi que les prochains timestamps d'exécution planifiés.

gethttps://api.moxon.dev/v4/cron

Cas d'utilisation

Prévisualisez les prochaines exécutions avant de planifier une tâche, affichez une description lisible d'une expression cron dans une interface, déboguez les problèmes de timing cron selon les fuseaux horaires, ou validez qu'une expression se déclenche aux intervalles attendus.

Essayerget/v4/cron

Paramètres

  • exprstringrequis

    Expression cron à 5 champs (minute heure dom mois dow). Exemple : */5 * * * *.

  • countnumberoptionnel

    Par défaut : 5.

    Nombre de prochains timestamps d'exécution à retourner (1–20).

  • fromstringoptionnel

    Par défaut : maintenant.

    Date de départ pour le calcul des prochaines exécutions (ISO 8601). Défaut : maintenant.

  • timezonestringoptionnel

    Par défaut : UTC.

    Fuseau horaire IANA pour le calcul et le formatage des timestamps (ex. Europe/Paris).

    • UTC
    • Europe/Paris
    • America/New_York
    • Asia/Tokyo
    • Australia/Sydney

Champs de réponse

  • expressionstring

    L'expression cron telle que fournie

  • descriptionstring

    Description lisible (ex. Every 5 minutes, At 09:00 daily)

  • timezonestring

    Fuseau horaire utilisé pour le calcul

  • nextstring[]

    Tableau des prochains timestamps d'exécution au format ISO 8601

Exemples de code

Gestion des erreurs

  • 400Please provide a cron expression (?expr=...)Le paramètre expr est manquant
  • 400Invalid cron expressionL'expression ne correspond pas au format cron à 5 champs
  • 400Count must be between 1 and 20Le paramètre count est hors de la plage autorisée
  • 400Please provide a valid ISO 8601 date (?from=...)Le paramètre from n'est pas une date ISO 8601 valide
  • 400Please provide a valid timezone (?timezone=...)Le paramètre timezone n'est pas un fuseau horaire IANA valide