Domain-Verfügbarkeit prüfen

GET /domains/availability/{domain}

Bezeichner: CheckDomainAvailability

Prüft, ob eine Domain noch registrierbar ist. Beantwortet vom regfish-Lookup-Dienst (RDAP/WHOIS gegen die Registries), derselben Quelle wie die Domainsuche auf regfish.de, nicht aus der Kontodatenbank. Der Endpunkt arbeitet bewusst auf jeder Domain, nicht nur auf denen des Accounts: Der Sinn ist gerade, nach Domains zu fragen, die noch niemandem gehören. Eine Prüfung, die nicht abgeschlossen werden kann (Registry nicht erreichbar, Timeout), liefert 502, statt die Domain als vergeben zu melden; Raten würde hier eine Registrierung kosten. Rate-Limit: 60 Prüfungen pro Minute und API-Key sowie 120 Prüfungen pro Minute und Account. Das Account-Limit gilt über alle API-Keys und OAuth-Clients hinweg; ein weiterer Schlüssel erhöht es nicht.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
domain	domain_name_checkable	ja	-

Antworten

Status	Typ	Beschreibung
200	domainAvailabilityResponse	Ergebnis der Verfügbarkeitsprüfung
400	Error	Kein gültiger, registrierbarer Domainname
401	Error	Nicht autorisiert
429	Error	Zu viele Verfügbarkeitsprüfungen
500	Error	Unerwarteter Fehler
502	Error	Verfügbarkeit konnte nicht ermittelt werden

Antwortkörper

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

Beispiel

curl -X GET "https://api.regfish.com/domains/availability/<domain>" \
  -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.