Documentation API

Authentification HTTP Basic · Réponses XML · REST

Connectez-vous pour voir vos identifiants API et tester les endpoints directement depuis cette page.

Se connecter

Authentification

Toutes les requêtes utilisent l'authentification HTTP Basic (RFC 7617). Passez votre identifiant et mot de passe API dans l'en-tête Authorization.

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

Endpoints

GET /time — Vérifier la connexion

Vérifie que les identifiants sont valides et que le service est disponible.

Réponse

<?xml version="1.0"?>
<rsp status="ok" timestamp="1745234567"/>
GET /cron.get — Lister les tâches

Retourne la liste de vos tâches avec pagination.

Paramètres

Nom Type Défaut Description
page int 1 Numéro de page
perpage int 100 Résultats par page (max 100)

Réponse

<?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 — Créer une tâche

Crée une nouvelle tâche.

Paramètres

Nom Type Défaut Description
name * string — Nom de la tâche
url * string — URL à appeler
minute string * Expression cron — minute
hour string * Expression cron — heure
day string * Expression cron — jour du mois
weekday string * Expression cron — jour de la semaine (0-6)
month string * Expression cron — mois
time_out int 30 Timeout en secondes (30, 180, 600, 1800, 3600)

Réponse

<?xml version="1.0"?>
<rsp status="ok" id="43"/>
POST /cron.edit — Modifier une tâche

Met à jour les champs fournis d'une tâche existante.

Paramètres

Nom Type Défaut Description
id * int — ID de la tâche
name string — Nouveau nom
url string — Nouvelle URL
status int — Activer (1) ou désactiver (0)
minute,hour,day,weekday,month string — Champs de planification

Réponse

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.delete — Supprimer une tâche

Supprime définitivement une tâche.

Paramètres

Nom Type Défaut Description
id * int — ID de la tâche

Réponse

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.state — Activer / Désactiver

Change l'état d'activation d'une tâche.

Paramètres

Nom Type Défaut Description
id * int — ID de la tâche
status * int — 1 = actif, 0 = inactif

Réponse

<?xml version="1.0"?>
<rsp status="ok"/>
GET /cron.logs — Historique d'exécution

Retourne les dernières exécutions d'une tâche.

Paramètres

Nom Type Défaut Description
id * int — ID de la tâche
perpage int 50 Nombre de logs à retourner

Réponse

<?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>

Réponses d'erreur

En cas d'erreur, le statut HTTP est 4xx et le corps XML contient le détail.

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