Nameserver-Delegation ändern (nur Vanity-Sets)

PUT /domains/{domain}/nameservers

Delegiert die Domain an eines der Vanity-Nameserver-Sets des Accounts (vanity_set_id) oder setzt sie auf die regfish-Standard-Nameserver zurück (vanity_set_id: null). Frei gewählte Nameserver unterstützt dieser Endpunkt bewusst NICHT; extern gehostete Delegationen sind im regfish dash zu verwalten.

Abgesichert durch den Domain-Guardian (Regelklasse ns_change), Prüfungen des Domain-Status (ausstehender Transfer, Kündigung) und ein tägliches Änderungslimit pro Domain.

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.