curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
Domaines personnalisés
Vérifier les enregistrements DNS d'un domaine personnalisé
POST /custom-domain/verify/
POST
/
custom-domain
/
verify
/
curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
Revérifie les enregistrements DNS d’un domaine personnalisé et met à jour son statut de vérification, sur l’hôte de l’API de gestion (
Il ne s’agit pas d’une vérification de statut — cela effectue une recherche DNS TXT et CNAME en direct sur le domaine à cet instant, et enregistre ce qui est trouvé (y compris
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
POST https://api.scanova.io/custom-domain/verify/
Authorization: YOUR_API_KEY
Nécessite un plan actif.
integer
requis
Le
id du domaine, obtenu via Lister les domaines personnalisés.curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
txt_error/cname_error en cas d’échec d’une recherche). Attendez-vous à ce que cet appel prenne un moment, et ne l’interrogez pas plus rapidement que ce que la propagation DNS pourrait jamais justifier. 400 si id n’est pas un domaine appartenant à ce compte.
Voir aussi
- Lister les domaines personnalisés — voir les indicateurs mis à jour sans relancer la vérification.
- Ajouter un domaine personnalisé — d’où proviennent
txt_value/cname_target. - Obtenir un lien de configuration Domain Connect — une voie alternative de configuration en un clic qui se vérifie automatiquement à la fin.
- Présentation de l’API de gestion — le schéma d’authentification et les règles de quota applicables à cet endpoint.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Réponse
Domain with updated verification flags.
Cette page vous a-t-elle été utile ?