Documentazione API

Autenticazione HTTP Basic · Risposte XML · REST

Accedi per visualizzare le tue credenziali API e testare gli endpoint direttamente da questa pagina.

Accedi

Autenticazione

Tutte le richieste usano l'autenticazione HTTP Basic (RFC 7617). Passa il tuo login e password API nell'header Authorization.

curl -u "API_IDENTIFIER:API_SECRET_KEY" \
     https://dev.webcron.org/cron.get

Endpoint

GET /time — Verifica connessione

Verifica che le credenziali siano valide e che il servizio sia disponibile.

Risposta

<?xml version="1.0"?>
<rsp status="ok" timestamp="1745234567"/>
GET /cron.get — Elenca i cronjob

Restituisce i tuoi cronjob con paginazione.

Parametri

Nome Tipo Predefinito Description
page int 1 Numero di pagina
perpage int 100 Risultati per pagina (max 100)

Risposta

<?xml version="1.0"?>
<rsp status="ok" total="3">
  <cron id="42" name="My job" url="https://example.com/run"
        status="1" time_out="30" one_off="0">
    <time minute="*/5" hour="*" day="*" weekday="*" month="*"/>
  </cron>
</rsp>
POST /cron.add — Crea un cronjob

Crea un nuovo cronjob.

Parametri

Nome Tipo Predefinito Description
name * string — Nome del cronjob
url * string — URL da chiamare
minute string * Espressione cron — minuto
hour string * Espressione cron — ora
day string * Espressione cron — giorno del mese
weekday string * Espressione cron — giorno della settimana (0-6)
month string * Espressione cron — mese
time_out int 30 Timeout in secondi (30, 180, 600, 1800, 3600)

Risposta

<?xml version="1.0"?>
<rsp status="ok" id="43"/>
POST /cron.edit — Modifica un cronjob

Aggiorna i campi forniti di un cronjob esistente.

Parametri

Nome Tipo Predefinito Description
id * int — ID del cronjob
name string — Nuovo nome
url string — Nuovo URL
status int — Abilita (1) o disabilita (0)
minute,hour,day,weekday,month string — Campi di pianificazione

Risposta

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.delete — Elimina un cronjob

Elimina definitivamente un cronjob.

Parametri

Nome Tipo Predefinito Description
id * int — ID del cronjob

Risposta

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.state — Abilita / Disabilita

Cambia lo stato di attivazione di un cronjob.

Parametri

Nome Tipo Predefinito Description
id * int — ID del cronjob
status * int — 1 = attivo, 0 = inattivo

Risposta

<?xml version="1.0"?>
<rsp status="ok"/>
GET /cron.logs — Cronologia esecuzioni

Restituisce le ultime esecuzioni di un cronjob.

Parametri

Nome Tipo Predefinito Description
id * int — ID del cronjob
perpage int 50 Numero di voci di log da restituire

Risposta

<?xml version="1.0"?>
<rsp status="ok">
  <logs>
    <log date="2026-04-21 10:00:00" http_code="200" total_time="0.342"/>
    <log date="2026-04-21 09:00:00" http_code="200" total_time="0.298"/>
  </logs>
</rsp>

Risposte di errore

In caso di errore, lo stato HTTP è 4xx e il corpo XML contiene il dettaglio.

<?xml version="1.0"?>
<rsp status="error" error="Cron not found"/>