API REST
Gestisci i tuoi cron job in modo programmatico, in JSON.
Autenticazione
Crea una chiave in Account › Chiave API e inviala nell’intestazione Authorization: Bearer (o X-API-Key).
curl -H "Authorization: Bearer 7c_xxxxxxxx…" https://7cron.com/api/v1/me
Limite: 120 richieste al minuto. Date in UTC (ISO 8601). L’accesso API può essere un’opzione secondo il piano.
Endpoint
| GET /me | Il tuo account e i tuoi limiti |
| GET /jobs | Elenca i tuoi job |
| POST /jobs | Crea un job (HTTP o heartbeat) |
| GET /jobs/{id} | Dettagli del job |
| PATCH /jobs/{id} | Modifica un job (solo i campi inviati) |
| DELETE /jobs/{id} | Elimina un job e la sua cronologia |
| POST /jobs/{id}/run | Esegui ora un job HTTP |
| POST /jobs/{id}/pause | Metti in pausa un job |
| POST /jobs/{id}/resume | Riattiva un job |
| GET /jobs/{id}/logs?limit=50 | Ultime esecuzioni (max. 500) |
Base URL : https://7cron.com/api/v1
Esempio e campi
Stessi campi e regole del modulo 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
Errori
{"error": {"code": 422, "message": "Validation failed.", "fields": {"cron_expr": "…"}}}
Codici: 400 JSON non valido, 401 chiave mancante, 403 non consentito, 404 non trovato, 405 metodo, 422 validazione, 429 limite di richieste.