Nameserver-Delegation ändern (nur Vanity-Sets)

PUT /domains/{domain}/nameservers

Bezeichner: PutNameserversByDomain

Delegiert die Domain an eines der Vanity-Nameserver-Sets des Accounts (vanity_set_id) oder stellt sie auf die regfish-Standard-Nameserver zurück (vanity_set_id: null). Freie Nameserver werden auf diesem Endpunkt bewusst NICHT unterstützt; extern gehostete Delegationen sind im regfish dash zu verwalten. Abgesichert durch den Domain-Guardian (Regelklasse ns_change), Domain-Statusprüfungen (laufender Transfer, Kündigung) und zwei Tageslimits: 5 Änderungen pro Domain und 50 Änderungen pro Account, beide gezählt über alle API-Keys und OAuth-Clients hinweg. Ein weiterer Schlüssel erhöht keines der beiden Limits.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
domain	fqdn_relaxed	ja	-

Request Body

nameserversUpdateRequest

Feld	Typ	Pflicht	Beschreibung
vanity_set_id	integer	ja	ID eines der Vanity-Nameserver-Sets des Accounts oder null, um auf die regfish-Standard-Nameserver zurückzusetzen. Frei gewählte Nameserver unterstützt dieser Endpunkt nicht.

Antworten

Status	Typ	Beschreibung
200	nameserversResponse	Delegation nach der Änderung
401	Error	Nicht autorisiert
403	Error	Vom Domain-Guardian blockiert
404	Error	Domain oder Vanity-Set nicht gefunden
409	Error	Domain-Status oder Tarif lässt die Änderung nicht zu
429	Error	Tageslimit für Änderungen erreicht
500	Error	Unerwarteter Fehler

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
success	boolean	ja	Erfolgskennzeichen
code	integer	nein	Antwort-/Fehlercode
response	nameserversResponse	nein	-

Beispiel

curl -X PUT "https://api.regfish.com/domains/<domain>/nameservers" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vanity_set_id": 0
  }'

Anfrage zusammenstellen

Werte eintragen - der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.