Aller au contenu
ENTRÉES GÉRÉES
AUTO-EXPIRATION
ACTIVER / DÉSACTIVER
EXPRESSIONS À 5 CHAMPS
MACROS @DAILY
ISOLATION PAR UTILISATEUR
ACCÈS CRONTAB BRUT
API REST
ENTRÉES GÉRÉES
AUTO-EXPIRATION
ACTIVER / DÉSACTIVER
EXPRESSIONS À 5 CHAMPS
MACROS @DAILY
ISOLATION PAR UTILISATEUR
ACCÈS CRONTAB BRUT
API REST
ENTRÉES GÉRÉES
AUTO-EXPIRATION
ACTIVER / DÉSACTIVER
EXPRESSIONS À 5 CHAMPS
MACROS @DAILY
ISOLATION PAR UTILISATEUR
ACCÈS CRONTAB BRUT
API REST
ENTRÉES GÉRÉES
AUTO-EXPIRATION
ACTIVER / DÉSACTIVER
EXPRESSIONS À 5 CHAMPS
MACROS @DAILY
ISOLATION PAR UTILISATEUR
ACCÈS CRONTAB BRUT
API REST
CronCron-as-a-Service

Cron-as-a-Service

Planifiez vos jobs avec des expressions standard à 5 champs ou des macros @daily. Gérez les entrées via REST, activez ou désactivez-les, et fixez une auto-expiration — sans SSH.

cron — hoody kit

# Crée un job cron qui tourne tous les jours à 9h

curl -X POST https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries \

-H 'Content-Type: application/json' \

-d '{ "schedule": "0 9 * * *", "command": "/usr/local/bin/backup.sh" }'

# Réponse

{

"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",

"schedule": "0 9 * * *",

"command": "/usr/local/bin/backup.sh",

"enabled": true,

"expires_at": null

}

# Désactive un job temporairement

curl -X PATCH https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \

-d '{ "schedule": "0 12 * * *" }'

# Entrée désactivée

RÉFÉRENCE DES EXPRESSIONS

Tous les patterns dont vous aurez besoin

Huit expressions avec leur équivalent lisible — directement issues du champ schedule_human de l'API.

Expression
Lecture humaine
Copier
* * * * *
Toutes les minutes
*/5 * * * *
Toutes les 5 minutes
0 * * * *
À la minute 0 (toutes les heures)
0 9 * * *
À 09:00
0 9 * * 1-5
À 09:00 du lundi au vendredi
0 0 1 * *
À 00:00 le 1er du mois
@daily
À 00:00 (macro)
@weekly
À 00:00 le dimanche (macro)
Macros : @hourly @daily @weekly @monthly @yearly
PLANIFICATEUR D'ENTRÉES

votre planning d'un coup d'œil

Quatre entrées gérées sur un axe glissant — exécutions à venir en bleu, entrées désactivées atténuées. Alimenté par schedule_human et l'état enabled.

-2h-1.5h-1h-0.5hnow+0.5h+1h+1.5h+2h+2.5h+3h

daily-backup

À 02:00

health-check

Toutes les 15 minutes

log-rotate

À 00:00 le dimanche

sync-reports

À 09:00 du lundi au vendredi

à venir
désactivé
passé
DEUX MODES

Géré ou brut — à vous de choisir

Entrées tracées par UUID avec toggle et expiration via l'API JSON, ou accès direct au fichier crontab quand vous maîtrisez votre workflow.

Entrées gérées

5 endpoints

CRUD adossé à un UUID — créez, lisez, mettez à jour, supprimez vos jobs cron via JSON. Ajoutez des commentaires, basculez l'état enabled, et fixez une auto-expiration sans toucher au crontab brut.

POST /users/{user}/entries

# Crée une entrée gérée

POST /users/{user}/entries

{

"schedule": "0 9 * * *",

"command": "/usr/local/bin/backup.sh",

"comment": "Daily backup at 9 AM",

"enabled": true

}

Crontab brut

3 endpoints

Accès complet en lecture/écriture au fichier crontab par utilisateur système. À utiliser quand vous voulez le contrôle total ou que vous avez déjà des workflows basés sur crontab.

GET /users/{user}/crontab

# Lit le crontab brut

GET /users/{user}/crontab

# Remplace tout le crontab

PUT /users/{user}/crontab

{ "crontab": "0 5 * * * /usr/local/bin/backup.sh" }

PATTERNS DE PLANIFICATION

Expressions cron courantes

Copie-colle ces plannings issus de la doc — chacun vérifié face à la référence d'expressions ci-dessus.

* * * * *

Chaque minute

Déclenche à chaque tic d'horloge. Idéal pour le polling continu, les collecteurs de métriques ou les processus watchdog.

0 * * * *

Chaque heure

Déclenche au début de chaque heure. Parfait pour les résumés horaires, le préchauffage de cache ou les syncs API planifiés.

0 9 * * 1-5

Jours ouvrés à 9h

Déclenche à 09:00 du lundi au vendredi seulement. Idéal pour les tâches sur heures de bureau — envois de digests quotidiens, génération de rapports.

0 0 1 * *

Premier du mois

Déclenche une fois par mois à minuit le 1er. Parfait pour les agrégations mensuelles, cycles de facturation et jobs d'archivage.

*/5 * * * *

Toutes les 5 minutes

Déclenche toutes les 5 minutes. Utile pour les health checks, vidanges de queue et synchronisations de données quasi temps réel.

@daily

Macro quotidienne

Équivalent à 0 0 * * * — minuit chaque jour. La façon la plus claire d'exprimer une planification une fois par jour.

ENDPOINTS API

9 endpoints. Deux modes.

Cinq endpoints CRUD pour entrées gérées, trois pour le crontab brut, et un health check — tous scopés par utilisateur système.

Entrées gérées

5 endpoints

https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/entries

GET
/users/{user}/entriesListe les entrées gérées
POST
/users/{user}/entriesCrée une entrée gérée
GET
/users/{user}/entries/{id}Récupère une entrée par ID
PATCH
/users/{user}/entries/{id}Met à jour une entrée
DELETE
/users/{user}/entries/{id}Supprime une entrée

Crontab brut

3 endpoints

https://abc123-def456-cron-1.node-us-1.containers.hoody.com/users/root/crontab

GET
/crontabListe tous les crontabs (paginé)
GET
/users/{user}/crontabRécupère le crontab brut d'un utilisateur
PUT
/users/{user}/crontabRemplace le crontab d'un utilisateur

Système

1 endpoint

https://abc123-def456-cron-1.node-us-1.containers.hoody.com/health

GET
/healthHealth check

Planifie votre premier job

Une requête POST. Une entrée cron. Zéro SSH. Hoody Cron tourne déjà dans votre container.

Voir la doc API