Zum Inhalt springen
Tutorial

Überprüfen Sie die Domänenverfügbarkeit mit einem API-Aufruf

| 5 min read

POSTEN Sie einen Domainnamen, erhalten Sie in weniger als 200 ms einen booleschen Verfügbarkeits- und Registrardaten zurück. Erstellen Sie Benutzeroberflächen für die Domainsuche in Echtzeit, prüfen Sie TLDs stapelweise und schlagen Sie Namen programmgesteuert vor.

Domain search bar on a minimalist screen
Photo by Stephen Phillips on Unsplash

Sie erstellen einen SaaS-Onboarding-Flow, der benutzerdefinierte Domänen für neue Arbeitsbereiche vorschlägt. Der Benutzer Geben Sie „acme“ ein und Ihre Benutzeroberfläche muss acme.com, acme.io, acme.dev in Echtzeit überprüfen. Registrar-APIs Sie erheben eine Gebühr pro Suche, erfordern Genehmigungsworkflows und legen strenge Ratenbeschränkungen fest. Du brauchst ein Leichte Verfügbarkeitsprüfung, die einen booleschen Wert zurückgibt und aus dem Weg geht.

Die Botoi /v1/domain/availability Der Endpunkt macht eines: Er sagt Ihnen, ob eine Domäne vorhanden ist ist registriert. Geben Sie einen Domainnamen ein und kehren Sie zurück available, registered, und der Name des Registrars, falls vorhanden. Kein Registrarkonto, kein WHOIS-Parsing, kein Scraping.

Der API-Aufruf

Wenn eine Domain verfügbar ist:

Wenn eine Domain vergeben ist:

Die Reaktion ist absichtlich minimal. available ist der boolesche Wert, auf den Sie verzweigen werden. registered ist die Umkehrung, zur besseren Lesbarkeit eingefügt. Wenn die Domain vergeben ist, wird die registrar Feld zeigt, wer es hält. Der Endpunkt fragt RDAP (das offizielle WHOIS) ab Nachfolger), daher sind die Daten maßgeblich.

Benutzeroberfläche für die Domainsuche in Echtzeit

Um eine Suche während der Eingabe zu ermöglichen, entprellen Sie die Eingabe und brechen Sie veraltete Anfragen mit an ab AbortController. Eine Verzögerung von 300 ms verhindert, dass bei jedem Tastendruck ausgelöst wird, während die Funktion erhalten bleibt Reaktionsfähige Benutzeroberfläche.

Die Abbruchlogik ist wichtig. Ohne sie kann eine langsame Antwort für „acm“ das Ergebnis für überschreiben „acme“, wenn die Anfragen nicht in der richtigen Reihenfolge aufgelöst werden. Der AbortController garantiert Ihnen Zeigt immer das Ergebnis für die letzte Eingabe an.

Führen Sie eine Stapelprüfung mehrerer TLDs durch

Die meisten Domain-Suchtools prüfen mehrere TLDs gleichzeitig. Parallele Anfragen mit abfeuern Promise.all und Ergebnisse als Raster anzeigen.

Fünf parallele Anfragen werden in der Zeit einer sequentiellen Anfrage abgeschlossen. Auf der kostenlosen Stufe (5 Anforderungen/Min., 100 Anforderungen/Tag), dies funktioniert für Entwicklung und Demos. Fügen Sie für die Produktion einen API-Schlüssel hinzu Tarifbegrenzungen aufzuheben.

Node.js-Domänenvorschlagsfunktion

Eine Domain-Vorschlagsmaschine generiert Kandidaten, indem sie das Schlüsselwort des Benutzers mit einem gemeinsamen Schlüsselwort kombiniert Präfixe und TLDs und filtert dann nach dem, was verfügbar ist. Hier ist eine vollständige Funktion, die Sie löschen können in ein Express- oder Hono-Backend.

Dabei werden 12 Kandidaten parallel geprüft (4 Präfixe x 3 TLDs). Die Funktion gibt nur verfügbar zurück Domains, sodass Ihr Frontend sie ohne zusätzliche Filterung als Vorschläge darstellen kann.

Express-Endpunkt für einen SaaS-Onboarding-Ablauf

Verknüpfen Sie die Stapelprüfung mit einer Express-Route, die Ihr Frontend während der Arbeitsbereichserstellung aufruft. Das Backend verwaltet den API-Schlüssel, sodass er niemals den Client erreicht.

Ihre Frontend-POSTs {"{ name: \"acme\" }"} und erhält eine Liste der Domains mit zurück Verfügbarkeitsstatus. Rendern Sie von dort aus grüne/rote Indikatoren und lassen Sie den Benutzer auswählen.

Wichtige Punkte

  • Ein Endpunkt, ein Zweck. POST /v1/domain/availability mit einem domain Feld. In der Antwort erfahren Sie, ob es registriert ist, wer der Registrar ist und nichts anderes.
  • RDAP-unterstützt. Der Endpunkt fragt RDAP ab, den von der ICANN genehmigten Ersatz für WHOIS. Kein Screen Scraping, kein sprödes Textparsen.
  • Funktioniert ohne API-Schlüssel. Anonymer Zugriff mit 5 Anfragen pro Minute Prototyping und Entwicklung. Fügen Sie einen Schlüssel hinzu, wenn Sie zur Produktion gehen.
  • Parallelfreundlich. TLDs stapelweise prüfen mit Promise.all. Fünf Schecks werden in der gleichen Zeit wie einer durchgeführt.
  • Antworten unter 200 ms. Edge-Bereitstellung auf Cloudflare Workers, daher die Latenz Der Engpass ist der Upstream-RDAP-Server, nicht die API selbst.

FAQ

Benötige ich einen API-Schlüssel, um die Domain-Verfügbarkeit zu prüfen?
Nein. Das kostenlose Kontingent ermöglicht anonymen Zugriff mit 5 Anfragen pro Minute mit IP-basierter Ratenbegrenzung. Fügen Sie für Batchprüfungen oder Produktionsanwendungen einen API-Schlüssel zum Autorisierungsheader hinzu, um höhere Grenzwerte zu erreichen.
Welche TLDs unterstützt der Domänenverfügbarkeitsendpunkt?
Der Endpunkt fragt RDAP-Server ab, die alle ICANN-akkreditierten TLDs abdecken, einschließlich .com, .net, .org, .io, .dev, .app und Hunderte von länderspezifischen TLDs. Die Abdeckung hängt davon ab, ob der TLD-Betreiber RDAP-Daten veröffentlicht.
Wie genau ist die Verfügbarkeitsprüfung?
Der Endpunkt fragt RDAP ab, den offiziellen Nachfolger von WHOIS. Ein 404 von RDAP bedeutet, dass die Domain nicht registriert ist. Eine 200 mit Registrierungsdaten bedeutet, dass es vergeben ist. Randfälle wie Premium-Domains oder von der Registrierungsstelle reservierte Namen werden möglicherweise als verfügbar angezeigt, obwohl sie nicht über normale Kanäle registriert werden können.
Enthält die Antwort WHOIS- oder Registrarinformationen?
Ja. Wenn eine Domäne registriert wird, enthält die Antwort den aus den RDAP-Entitätsdaten extrahierten Registrarnamen. Wenn die RDAP-Antwort keine Registrarinformationen enthält, wird das Registrarfeld weggelassen.
Kann ich mehrere Domains in einer einzigen Anfrage prüfen?
Der Endpunkt akzeptiert eine Domäne pro Anfrage. Senden Sie für Batch-Prüfungen parallele Anfragen mit Promise.all in JavaScript oder asyncio.gather in Python. Die API verarbeitet gleichzeitige Anfragen ohne Probleme bei Standardratenlimits.

Starte mit botoi zu entwickeln

150+ API-Endpunkte für Abfragen, Textverarbeitung, Bildgenerierung und Entwickler-Tools. Kostenloser Tarif, keine Kreditkarte nötig.