Domain verknüpfen

Custom-Domain mit Webspace verknüpfen. Fügt vhost-Servername hinzu und schreibt nginx/OLS-Konfiguration. Free-Tier-Webspaces können keine Custom-Domains verknüpfen.

Erforderlicher Scope: webspace:manage

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`
`Content-Type`	Ja	`application/json`

Body

Parameter	Erforderlich	Beschreibung
`domain`	Ja	Vollständiger Hostname (z. B. `blog.example.com`).
`domainId`	Ja	ID des Domain-Eintrags des Nutzers.
`dnsName`	Ja	Subdomain-Teil für den A-Record. Für die Wurzel `@` verwenden.

Antwort

{
  "data": {
    "id": "69ee...",
    "domain": "blog.example.com",
    "sslActive": false,
    "sslExpiry": null,
    "createdAt": "2026-04-22T12:34:56.000Z"
  }
}

Fehler

Status	Code	Beschreibung
400	`INVALID_DOMAIN`	Hostname fehlt oder ist ungültig.
403	`FREE_TIER_NO_CUSTOM_DOMAINS`	Free-Webspaces können keine Custom-Domains verknüpfen.
404	`DOMAIN_RECORD_NOT_FOUND`	Domain nicht gefunden oder nicht im Besitz des Nutzers.
409	`DOMAIN_LIMIT_REACHED`	Webspace hat das `allowedDomains`-Limit erreicht.
409	`DOMAIN_ALREADY_LINKED`	Hostname ist bereits anderswo verknüpft.

Beispiel

curl -X POST https://hosting.site.quest/api/v1/webspaces/69e80ac1.../domains \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "domain": "blog.example.com", "domainId": "69dd...", "dnsName": "blog" }'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.