Nameserver-Delegation ändern (Vanity-Sets oder zurück zu regfish)

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 um (vanity_set_id: null). Freie Nameserver werden auf diesem Endpunkt bewusst NICHT unterstützt; eine Delegation an fremde Nameserver richten Sie im regfish dash ein.

vanity_set_id: null funktioniert von jedem Ausgangspunkt aus:

• Aus einem Vanity-Set: immer möglich, die gehostete Zone bleibt unverändert.
• Von fremden Nameservern: möglich, wenn die TLD für den Nameserver-Wechsel keine Gebühr verlangt. Hält regfish noch keine DNS-Zone für die Domain, wird sie nur mit den regfish-NS-Records angelegt; legen Sie Ihre Records direkt danach an (POST /dns/rr), sie werden ausgeliefert, sobald die Registry die Delegation umgestellt hat. Kostet der Wechsel bei der TLD eine Gebühr, antwortet die API mit 409 und einem Link ins regfish dash, wo die Gebühr angezeigt und bestätigt wird; die API rechnet sie nie ab. Ein aktives oder gerade wechselndes DNSSEC führt ebenfalls zu 409: Schalten Sie DNSSEC zuerst ab.
• Bereits auf den regfish-Nameservern: idempotent; eine fehlende Zone wird angelegt, an die Registry geht nichts.

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 die Domain auf die regfish-Standard-Nameserver umzustellen (auch von fremden Nameservern, siehe Beschreibung des Endpunkts). 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.