curl -X PATCH "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"root_action": "url_redirect",
"redirect": "https://example.com/landing"
}'
{
"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": "url_redirect",
"redirect": "https://example.com/landing",
"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
Mettre à jour un domaine personnalisé
PATCH /custom-domain//
PATCH
/
custom-domain
/
{pk}
/
curl -X PATCH "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"root_action": "url_redirect",
"redirect": "https://example.com/landing"
}'
{
"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": "url_redirect",
"redirect": "https://example.com/landing",
"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"
}
Met à jour la configuration d’un domaine personnalisé, sur l’hôte de l’API de gestion (
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
PUT https://api.scanova.io/custom-domain/{pk}/
PATCH https://api.scanova.io/custom-domain/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
integer
requis
Le
id du domaine.boolean
Si les nouveaux codes QR utilisent ce domaine par défaut.
string
Ce qu’il faut faire lorsque quelqu’un visite le domaine nu (sans slug QR) :
no_action (par défaut), url_redirect, ou custom_page.string
L’URL vers laquelle envoyer les visiteurs lorsque
root_action est url_redirect.integer
Un id
CustomDomainTemplate servant de page racine lorsque root_action est custom_page — voir Lister les modèles de page racine de domaine personnalisé.string
none, http, ou https. Vide correspond par défaut à https.boolean
Retire le paramètre de suivi
?qr=1 des URL de lien court lorsqu’il est défini.curl -X PATCH "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"root_action": "url_redirect",
"redirect": "https://example.com/landing"
}'
{
"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": "url_redirect",
"redirect": "https://example.com/landing",
"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"
}
La plupart des champs sont en lecture seule ici
Seulsis_default, root_action, redirect, template, protocol et remove_qr_query peuvent être écrits via cet endpoint — tous les autres champs, y compris domain lui-même, sont en lecture seule une fois le domaine créé. 404 si pk n’est pas un domaine appartenant à ce compte.
Voir aussi
- Récupérer un domaine personnalisé — consulter avant de mettre à jour.
- Lister les modèles de page racine de domaine personnalisé — trouver un id
templatepourcustom_page. - 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.
Paramètres de chemin
Réponse
Domain updated.
Cette page vous a-t-elle été utile ?