API REST

Gérez vos tâches cron par programme, en JSON.

Authentification

Créez une clé dans Compte › Clé API et envoyez-la dans l’en-tête Authorization: Bearer (ou X-API-Key).

curl -H "Authorization: Bearer 7c_xxxxxxxx…" https://7cron.com/api/v1/me

Limite : 120 requêtes par minute. Dates en UTC (ISO 8601). L’accès API peut être une option selon votre offre.

Points d’accès

GET /meVotre compte et vos limites
GET /jobsLister vos tâches
POST /jobsCréer une tâche (HTTP ou heartbeat)
GET /jobs/{id}Détail d’une tâche
PATCH /jobs/{id}Modifier une tâche (seulement les champs envoyés)
DELETE /jobs/{id}Supprimer une tâche et son historique
POST /jobs/{id}/runExécuter une tâche HTTP maintenant
POST /jobs/{id}/pauseMettre une tâche en pause
POST /jobs/{id}/resumeRéactiver une tâche
GET /jobs/{id}/logs?limit=50Dernières exécutions (500 max.)

Base URL : https://7cron.com/api/v1

Exemple et champs

Mêmes champs et mêmes règles que le formulaire web :

curl -X POST https://7cron.com/api/v1/jobs \
  -H "Authorization: Bearer 7c_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{"name":"Nightly backup","url":"https://example.com/cron/backup",
       "method":"POST","cron_expr":"0 3 * * *","timezone":"Europe/Zurich",
       "timeout":30,"retries":1,"alert_threshold":3,"success_keyword":"OK"}'

# Heartbeat
curl -X POST https://7cron.com/api/v1/jobs -H "Authorization: Bearer 7c_…" -H "Content-Type: application/json" \
  -d '{"type":"heartbeat","name":"Backup script","hb_period_min":1440,"hb_grace_min":30}'

type, name, url, method, headers, body, cron_expr, timezone, timeout, enabled, notify_on_failure, notify_chat, alert_threshold, webhook_url, success_keyword, keyword_mode (contains|absent), retries, hb_period_min, hb_grace_min, on_status_page

Erreurs

{"error": {"code": 422, "message": "Validation failed.", "fields": {"cron_expr": "…"}}}

Codes : 400 JSON invalide, 401 clé absente, 403 non autorisé, 404 introuvable, 405 méthode, 422 validation, 429 limite de débit.