Créer un site

Ajoute un nouveau site. Retourne un validation_token nécessaire pour prouver la propriété du site. Les sites non vérifiés sont limités à 10 URLs par boost.

POST /v1/sites

Scope requis : sites:write

Paramètres du corps

Paramètre	Type	Requis	Description
`domain`	string	Requis	Domaine sans schéma ni slash final. Le préfixe `https://` est supprimé automatiquement.

Exemple de requête

curl -X POST https://api.cache-boost.com/v1/sites \
  -H "Authorization: Bearer cb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "www.example.com"}'

Réponse

Retourne 201 Created avec le nouvel objet site.

{
  "id": 42,
  "domain": "www.example.com",
  "validated": false,
  "validation_token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "created_at": "2025-01-15T10:30:00Z"
}

Utilisez le validation_token pour vérifier la propriété du site. Consultez le guide Autoriser le trafic.

Erreurs

Code	Description
`401`	Clé API manquante ou invalide.
`403`	Scope insuffisant.
`422`	Erreur de validation — `domain` manquant ou invalide.