Lister les runs
Retourne l'historique des runs de tous les boosts, du plus récent au plus ancien.
/v1/runs
Scope requis : runs:read
Paramètres de requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
boost_id | integer | Optionnel | Filtrer par identifiant de boost. |
limit | integer | Optionnel | Nombre de résultats par page. Défaut : 20, max : 100. |
offset | integer | Optionnel | Dé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
| Valeur | Description |
|---|---|
pending | Run en attente de démarrage. |
running | Run en cours. |
done | Run terminé avec succès. |
failed | Run terminé avec des erreurs. |
paused | Run 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_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. |