Récupérer un run

Récupère un run par son identifiant, avec les statistiques complètes.

GET /v1/runs/{id}

Scope requis : runs:read

Paramètres de chemin

Paramètre	Type	Requis	Description
`id`	integer	Requis	Identifiant du run.

Exemple de requête

curl https://api.cache-boost.com/v1/runs/88 \
  -H "Authorization: Bearer cb_live_YOUR_KEY"

Réponse

Retourne 200 OK avec l'objet run incluant le nom du boost et l'identifiant du site.

{
  "id": 88,
  "boost_id": 15,
  "boost_name": "Daily warm",
  "site_id": 42,
  "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"
}

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_status	Description
`verified`	Au moins 80 % des vérifications concluantes sont des cache hits.
`to_fix`	Moins de 80 % des vérifications concluantes sont des cache hits.
`probable`	Le 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_verified`	Aucune vérification concluante : validation désactivée, run créé avant la fonctionnalité, ou résultats uniquement non concluants.
`in_progress`	Le 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

Code	Description
`401`	Clé API manquante ou invalide.
`403`	Scope insuffisant ou accès refusé.
`404`	Run introuvable.