curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"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
Ajouter un domaine personnalisé
POST /custom-domain/
POST
/
custom-domain
/
curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"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"
}
Connecte un nouveau domaine personnalisé au compte, sur l’hôte de l’API de gestion (
Ajouter un domaine ne le vérifie pas —
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requis
Le domaine à connecter, par ex.
links.example.com. Un préfixe de schéma, une barre oblique finale et la casse sont tous normalisés automatiquement — envoyez-le comme vous le souhaitez.curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"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_value et cname_target dans la réponse sont les enregistrements DNS que vous (ou le propriétaire du domaine) devez encore ajouter, et is_txt_verified/is_cname_verified démarrent à false. Scanova vérifie de manière asynchrone, juste après la création, si le registraire du domaine prend en charge la configuration en un clic via Domain Connect ; domain_connect_supported reflète le résultat une fois cette vérification terminée.
400 si le domaine est invalide ou déjà connecté à un compte quelconque (la vérification d’unicité ne tient pas compte de la casse). 403 si le compte n’a pas le quota CUSTOM_DOMAIN, a un plan inactif, n’a pas la permission CUSTOM_DOMAIN_CAN_ADD, ou a atteint sa limite de domaines.
Voir aussi
- Lister les domaines personnalisés — voir les domaines connectés.
- Vérifier les enregistrements DNS d’un domaine personnalisé — vérifier les enregistrements une fois ajoutés.
- Obtenir un lien de configuration Domain Connect — configuration DNS en un clic, si prise en charge.
- Envoyer les instructions de configuration DNS par e-mail — déléguer les étapes manuelles à quelqu’un d’autre.
- 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: 401f7ac837da42b97f613d789819ff93537bee6a. 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 added.
Cette page vous a-t-elle été utile ?