Valider un site
Déclenche une vérification de propriété pour un site. CacheBoost effectue une requête HTTP vers le site et recherche le token de validation.
POST
/v1/sites/{id}/validate
Scope requis : sites:write
La vérification est synchrone — le résultat est retourné immédiatement. CacheBoost essaie deux méthodes, dans l'ordre, en HTTPS puis HTTP :
- Fichier HTML — un fichier nommé
{validation_token}.htmldoit être accessible à la racine du site et retourner HTTP 200. - Meta tag — la page d'accueil doit contenir
<meta name="cacheboost-token" content="{validation_token}">dans son<head>.
Le validation_token est retourné lors de la création d'un site (POST /v1/sites) et également via GET /v1/sites/{id}.
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
id | integer | Identifiant du site. |
Exemple de requête
curl -X POST https://api.cache-boost.com/v1/sites/42/validate \
-H "Authorization: Bearer cb_live_YOUR_KEY"
Réponses
200 — Validation réussie
{ "validated": true }
200 — Déjà validé
{ "validated": true, "already_validated": true }
422 — Token introuvable
{
"validated": false,
"error": "Validation token not found on the site."
}
Erreurs
| Code | Description |
|---|---|
401 | Clé API manquante ou invalide. |
403 | Scope insuffisant (sites:write requis). |
404 | Site introuvable ou inaccessible avec cette clé. |
422 | Token de validation introuvable sur le site. |