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"
}
Dominios personalizados
Agregar un dominio personalizado
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"
}
Conecta un nuevo dominio personalizado a la cuenta, en el host de la API de gestión (
Agregar un dominio no lo verifica —
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requerido
El dominio a conectar, p. ej.
links.example.com. El prefijo de esquema, la barra final y las mayúsculas/minúsculas se normalizan automáticamente — envíelo como prefiera.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 y cname_target en la respuesta son los registros DNS que usted (o el propietario del dominio) todavía necesita añadir, y is_txt_verified/is_cname_verified comienzan en false. Scanova comprueba de forma asíncrona, justo después de la creación, si el registrador del dominio admite la configuración de un clic mediante Domain Connect; domain_connect_supported refleja el resultado una vez que esa comprobación se completa.
400 si el dominio no es válido o ya está conectado a alguna cuenta (la comprobación de unicidad no distingue mayúsculas/minúsculas). 403 si a la cuenta le falta la cuota CUSTOM_DOMAIN, tiene un plan inactivo, carece del permiso CUSTOM_DOMAIN_CAN_ADD, o ha alcanzado su límite de dominios.
Relacionado
- Listar dominios personalizados — ver los dominios conectados.
- Verificar los registros DNS de un dominio personalizado — comprobar los registros una vez añadido.
- Obtener un enlace de configuración de Domain Connect — configuración DNS de un clic, cuando esté disponible.
- Enviar instrucciones de configuración de DNS por correo — delegar los pasos manuales a otra persona.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota aplicables a este endpoint.
Autorizaciones
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.
Respuesta
Domain added.
¿Esta página le ayudó?