API-Dokumentation

Nameserver aktualisieren

Aktualisiert die Nameserver für eine Domain.

Anfrage

PUT /api/v1/domains/{id}/nameservers

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

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

Anfragekörper

Feld Typ Erforderlich Beschreibung
ns1 string Ja Primärer Nameserver
ns2 string Ja Sekundärer Nameserver
ns3 string Nein Dritter Nameserver
ns4 string Nein Vierter Nameserver
ns5 string Nein Fünfter Nameserver

Antwort

{
  "data": {
    "ns1": "ns1.example.com",
    "ns2": "ns2.example.com",
    "ns3": null,
    "ns4": null,
    "ns5": null
  }
}

Antwortfelder

Feld Typ Beschreibung
data.ns1 string Primärer Nameserver
data.ns2 string Sekundärer Nameserver
data.ns3 string | null Dritter Nameserver
data.ns4 string | null Vierter Nameserver
data.ns5 string | null Fünfter Nameserver

Fehler

Status Code Beschreibung
400 INVALID_NS Einer oder mehrere Nameserver-Werte sind ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/nameservers \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "ns1": "ns1.example.com",
    "ns2": "ns2.example.com"
  }'

MCP

Diese Aktion ist auch über das set_nameservers MCP-Tool verfügbar.