Domain-Verfügbarkeit prüfen
GET /domains/availability/{domain}Prüft, ob eine Domain noch registrierbar ist. Die Antwort stammt aus dem regfish-Lookup-Dienst (RDAP/WHOIS gegen die Registries) – derselben Quelle, aus der auch die Domainsuche auf regfish.de gespeist wird – und nicht aus der Account-Datenbank.
Dieser Endpunkt arbeitet bewusst auf jeder Domain, nicht nur auf denen des Accounts: Der Sinn der Sache ist ja, nach Domains zu fragen, die noch niemandem gehören.
Eine Prüfung, die sich nicht abschließen lässt (Registry nicht erreichbar, Timeout), liefert 502, statt die Domain als vergeben zu melden – Raten würde den Kunden hier eine Registrierung kosten.
Rate-Limit: 60 Prüfungen pro Minute und API-Key.
Pfad-Parameter
Abschnitt betitelt „Pfad-Parameter“| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domain |
domain_name_checkable | ja | — |
Antworten
Abschnitt betitelt „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
Abschnitt betitelt „Antwortkörper“| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
success |
boolean |
ja | Erfolgskennzeichen |
code |
integer |
nein | Antwort-/Fehlercode |
response |
domainAvailabilityResponse | nein | — |
Beispiel
Abschnitt betitelt „Beispiel“curl -X GET "https://api.regfish.com/domains/availability/<domain>" \ -H "x-api-key: $REGFISH_API_KEY"Anfrage zusammenstellen
Abschnitt betitelt „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.