Préchauffer des URLs

Déclenche un préchauffage de cache à la demande pour une liste d'URLs spécifique. La réponse est 202 Accepted — le run est mis en file d'attente et traité de manière asynchrone.

POST /v1/sites/{id}/warm

Scope requis : boosts:write

Paramètres de chemin

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

Paramètres du corps

Paramètre	Type	Requis	Description
`urls`	array	Requis	Liste des URLs à préchauffer. Toutes les URLs doivent appartenir au domaine du site. Maximum 5 000 URLs par requête.
`region`	array	Optionnel	Régions cibles : `fr`, `us`, `eu`, `as`. Par défaut : `["fr"]`.
`variations`	object	Optionnel	`user_agents` (mobile, desktop, bot, ai_crawler) et `languages`. Chaque combinaison compte comme un appel par URL.

Exemple de requête

curl -X POST https://api.cache-boost.com/v1/sites/42/warm \
  -H "Authorization: Bearer cb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://www.example.com/", "https://www.example.com/about"], "region": ["fr", "us"]}'

Réponse

Retourne 202 Accepted.

{
  "run_id": 91,
  "url_count": 2,
  "status": "pending"
}

Le run est asynchrone. Utilisez le run_id retourné pour interroger GET /v1/runs/{id} et suivre la progression. Le site doit être validé avant de pouvoir préchauffer.

Erreurs

Code	Description
`401`	Clé API manquante ou invalide.
`403`	Scope insuffisant, accès refusé ou quota dépassé.
`404`	Site introuvable.
`409`	Le site n'est pas validé, ou un run warm est déjà en cours.
`422`	Erreur de validation — champs manquants ou invalides, ou URLs hors du domaine du site.