Lister les runs warm
Retourne l'historique des runs de préchauffage à la demande pour un site, du plus récent au plus ancien.
/v1/sites/{id}/warm-runs
Scope requis : boosts:read
Paramètres de chemin
| Paramètre | Type | Requis | Description |
|---|---|---|---|
id |
integer | Requis | Identifiant du site. |
Paramètres de requête
| Paramètre | Type | Description |
|---|---|---|
limit | integer | Nombre de résultats à retourner. Défaut : 20, maximum : 100. |
offset | integer | Décalage de pagination. Défaut : 0. |
Exemple de requête
curl https://api.cache-boost.com/v1/sites/42/warm-runs \
-H "Authorization: Bearer cb_live_YOUR_KEY"
Réponse
Retourne 200 OK.
{
"data": [
{
"id": 91,
"status": "done",
"status_message": null,
"source_urls": ["https://www.example.com/", "https://www.example.com/about"],
"run_region": ["fr", "us"],
"started_at": "2025-01-15T10:31:00Z",
"finished_at": "2025-01-15T10:31:45Z",
"summary": {
"total_calls": 4,
"successful_calls": 4,
"failed_calls": 0,
"cache_hits": 3,
"average_response_time_ms": 98.2,
"pops": { "CDG": 2, "IAD": 2 }
},
"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-15T10:30:58Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
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 | Site introuvable. |