Fonctionnalités Tarifs Régions Support Essai gratuit Connexion EN

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 :

  1. Fichier HTML — un fichier nommé {validation_token}.html doit être accessible à la racine du site et retourner HTTP 200.
  2. 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ètreTypeDescription
idintegerIdentifiant 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

CodeDescription
401Clé API manquante ou invalide.
403Scope insuffisant (sites:write requis).
404Site introuvable ou inaccessible avec cette clé.
422Token de validation introuvable sur le site.