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"
}
Benutzerdefinierte Domains
Benutzerdefinierte Domain hinzufügen
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"
}
Verbindet eine neue benutzerdefinierte Domain mit dem Konto, auf dem Management-API-Host (
Das Hinzufügen einer Domain verifiziert sie nicht —
api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
erforderlich
Die zu verbindende Domain, z. B.
links.example.com. Ein Schema-Präfix, ein abschließender Schrägstrich und Groß-/Kleinschreibung werden automatisch normalisiert — senden Sie sie in beliebiger Form.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 und cname_target in der Antwort sind die DNS-Einträge, die Sie (oder der Domaininhaber) noch hinzufügen müssen, und is_txt_verified/is_cname_verified starten mit false. Scanova prüft direkt nach der Erstellung asynchron, ob der Registrar der Domain die Ein-Klick-Einrichtung über Domain Connect unterstützt; domain_connect_supported spiegelt das Ergebnis wider, sobald diese Prüfung abgeschlossen ist.
400, wenn die Domain ungültig oder bereits mit einem beliebigen Konto verbunden ist (die Eindeutigkeitsprüfung ist Groß-/Kleinschreibung-unabhängig). 403, wenn dem Konto die Quota CUSTOM_DOMAIN fehlt, der Plan inaktiv ist, die Berechtigung CUSTOM_DOMAIN_CAN_ADD fehlt, oder das Domain-Limit erreicht ist.
Verwandte Themen
- Benutzerdefinierte Domains auflisten — verbundene Domains ansehen.
- DNS-Einträge einer benutzerdefinierten Domain verifizieren — die Einträge nach dem Hinzufügen prüfen.
- Domain-Connect-Einrichtungslink abrufen — Ein-Klick-DNS-Einrichtung, sofern unterstützt.
- DNS-Einrichtungsanweisungen per E-Mail senden — die manuellen Schritte an jemand anderen weitergeben.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.
Autorisierungen
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.
Antwort
Domain added.
War diese Seite hilfreich?