AuthInfo-Code für Domain anfordern

POST /domains/{domain}/authinfo

Bezeichner: RequestAuthinfoByDomain

Erzeugt den Transfer-Autorisierungscode (AuthInfo) für die Domain bei der Registry. Der Code ermöglicht einen ausgehenden Transfer; er ist nur auf ausdrücklichen Wunsch des Domaininhabers anzufordern. Abgesichert durch den Domain-Guardian (Regelklasse authinfo) und begrenzt auf 3 Anfragen pro Domain und 10 pro Account und Tag - das Account-Limit ist die Grenze, die ein massenhaftes Abgreifen über das gesamte Portfolio verhindert. Beide Limits werden über alle API-Keys und OAuth-Clients hinweg gezählt; ein weiterer Schlüssel erhöht sie nicht. Für einen legitimen Sammelumzug zu einem anderen Registrar kann der Support die Grenzen für den Account befristet anheben. Jeder ausgegebene Code wird im Domain-Guard-Log vermerkt (Ergebnis issued), ebenso jede Ablehnung.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
domain	fqdn_relaxed	ja	-

Antworten

Status	Typ	Beschreibung
200	authinfoResponse	Erzeugter AuthInfo-Code
401	Error	Nicht autorisiert
403	Error	Vom Domain-Guardian blockiert
404	Error	Domain nicht gefunden
429	Error	Tageslimit für AuthInfo-Anfragen erreicht (pro Domain oder pro Account)
500	Error	Unerwarteter Fehler
502	Error	Fehler bei der Registry

Antwortkörper

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

Beispiel

curl -X POST "https://api.regfish.com/domains/<domain>/authinfo" \
  -H "x-api-key: $REGFISH_API_KEY"

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.