Offre de fin d'année : -50 % sur tous les forfaits pendant 12 mois, jusqu'au 31 décembre 2026 -50 % sur tous les forfaits En profiter →
Fonctionnalités Tarifs -50 % Régions Support Blog ⚡ Audit gratuit Essai gratuit Connexion EN

Lister les runs

Retourne l'historique des runs de tous les boosts, du plus récent au plus ancien.

GET /v1/runs

Scope requis : runs:read

Paramètres de requête

ParamètreTypeRequisDescription
boost_idintegerOptionnelFiltrer par identifiant de boost.
limitintegerOptionnelNombre de résultats par page. Défaut : 20, max : 100.
offsetintegerOptionnelDécalage de pagination. Défaut : 0.

Exemple de requête

curl "https://api.cache-boost.com/v1/runs?boost_id=15&limit=20" \
  -H "Authorization: Bearer cb_live_YOUR_KEY"

Réponse

Retourne 200 OK avec une liste paginée de runs.

{
  "data": [
    {
      "id": 88,
      "boost_id": 15,
      "status": "done",
      "status_message": null,
      "started_at": "2025-01-15T01:00:05Z",
      "finished_at": "2025-01-15T01:04:22Z",
      "summary": {
        "total_calls": 1240,
        "successful_calls": 1238,
        "failed_calls": 2,
        "cache_hits": 1165,
        "average_response_time_ms": 112.5,
        "pops": {"CDG": 620, "AMS": 618}
      },
      "validation": {
        "ratio": 10,
        "sampled": 11,
        "count_hit": 10,
        "count_hit_timing": 0,
        "count_miss": 1,
        "count_pop_mismatch": 0,
        "count_error": 0,
        "count_unknown": 0,
        "avg_first_time": 429,
        "avg_check_time": 61,
        "causes": {"set-cookie": 1},
        "capped": false,
        "skipped": null
      },
      "validation_status": "verified",
      "created_at": "2025-01-15T01:00:00Z"
    }
  ],
  "limit": 20,
  "offset": 0
}

Valeurs de statut

ValeurDescription
pendingRun en attente de démarrage.
runningRun en cours.
doneRun terminé avec succès.
failedRun terminé avec des erreurs.
pausedRun mis en pause suite à un taux d'erreur élevé.

Champs de validation

Quand une vérification après préchauffage est demandée (validation_ratio supérieur à 0), une partie des URLs préchauffées est appelée une seconde fois puis comparée au premier appel. Les runs sans vérification renvoient "validation": null.

validation_statusDescription
verifiedAu moins 80 % des vérifications concluantes sont des cache hits.
to_fixMoins de 80 % des vérifications concluantes sont des cache hits.
probableLe site n'envoie aucun en-tête de statut de cache (aucun HIT ni MISS lu) : le contrôle n'a pu comparer que les temps de réponse. Le taux porte alors sur tout l'échantillon.
not_verifiedAucune vérification concluante : validation désactivée, run créé avant la fonctionnalité, ou résultats uniquement non concluants.
in_progressLe run est en cours et ses vérifications sont en attente. Interrogez à nouveau : validation vaut null jusqu'à la fin du run.

Le taux est (count_hit + count_hit_timing) / (count_hit + count_hit_timing + count_miss). count_pop_mismatch, count_error et count_unknown sont non concluants et exclus. Quand count_hit et count_miss valent tous deux 0 (probable), aucune page ne peut être un miss : le taux vaut alors count_hit_timing / (count_hit_timing + count_unknown). avg_first_time et avg_check_time (ms) sont les temps de réponse moyens du premier et du second appel. causes compte les miss par cause. capped vaut true quand le quota a réduit l'échantillon ; skipped vaut "quota" quand il l'a annulé.

Erreurs

CodeDescription
401Clé API manquante ou invalide.
403Scope insuffisant.