Aller au contenu
Tutorial

Vérifiez la disponibilité du domaine avec un seul appel API

| 5 min read

POSTez un nom de domaine, obtenez une disponibilité booléenne et les données du registraire en moins de 200 ms. Créez des interfaces utilisateur de recherche de domaine en temps réel, vérifiez par lots les TLD et suggérez des noms par programmation.

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

Vous créez un flux d'intégration SaaS qui suggère des domaines personnalisés pour les nouveaux espaces de travail. L'utilisateur tapez "acme" et votre interface utilisateur doit vérifier acme.com, acme.io, acme.dev en temps réel. API du registraire facturer par recherche, exiger des flux de travail d’approbation et imposer des limites de taux strictes. Vous avez besoin d'un contrôle de disponibilité léger qui renvoie un booléen et s'écarte.

Le botoï /v1/domain/availability le point de terminaison fait une chose : vous indique si un domaine est enregistré. POSTEZ un nom de domaine, revenez available, registered, et le nom du registraire s'il existe. Pas de compte de bureau d'enregistrement, pas d'analyse WHOIS, pas de scraping.

L'appel API

Lorsqu'un domaine est disponible :

Lorsqu'un domaine est pris :

La réponse est volontairement minime. available est le booléen sur lequel vous allez créer un branchement. registered est son inverse, inclus pour plus de lisibilité. Lorsque le domaine est pris, le registrar le champ montre qui le détient. Le point de terminaison interroge RDAP (le WHOIS officiel successeur), les données font donc autorité.

Interface utilisateur de recherche de domaine en temps réel

Pour une expérience de recherche au fur et à mesure de la frappe, annulez la saisie et annulez les requêtes obsolètes avec un AbortController. Un délai de 300 ms empêche le déclenchement à chaque frappe tout en gardant le Interface utilisateur réactive.

La logique d’abandon est importante. Sans cela, une réponse lente pour "acm" peut écraser le résultat pour "acme" si les demandes sont résolues dans le désordre. Le AbortController vous garantit affiche toujours le résultat de la dernière entrée.

Vérification par lots de plusieurs TLD

La plupart des outils de recherche de domaines vérifient plusieurs TLD à la fois. Lancez des requêtes parallèles avec Promise.all et afficher les résultats sous forme de grille.

Cinq requêtes parallèles se terminent dans le temps d’une requête séquentielle. Sur le niveau gratuit (5 req/min, 100 req/jour), cela fonctionne pour le développement et les démos. Pour la production, ajoutez une clé API pour supprimer les limites de taux.

Fonctionnalité de suggestion de domaine Node.js

Un moteur de suggestion de domaine génère des candidats en combinant le mot-clé de l'utilisateur avec des mots-clés communs. préfixes et TLD, puis filtre ce qui est disponible. Voici une fonction complète que vous pouvez supprimer dans un backend Express ou Hono.

Celui-ci vérifie 12 candidats en parallèle (4 préfixes x 3 TLD). La fonction renvoie uniquement disponible domaines, afin que votre interface puisse les afficher sous forme de suggestions sans aucun filtrage supplémentaire.

Point de terminaison express pour un flux d'intégration SaaS

Câblez la vérification par lots à une route Express que votre interface appelle lors de la création de l'espace de travail. Le backend gère la clé API, elle n'atteint donc jamais le client.

Vos POST frontend {"{ name: \"acme\" }"} et récupère une liste de domaines avec état de disponibilité. À partir de là, affichez les indicateurs vert/rouge et laissez l’utilisateur choisir.

Points clés

  • Un point final, un objectif. POSTE /v1/domain/availability avec un domain champ. La réponse vous indique s'il est enregistré, qui est le registraire et rien d'autre.
  • Soutenu par RDAP. Le point de terminaison interroge RDAP, le remplacement sanctionné par l'ICANN pour WHOIS. Pas de grattage d'écran, pas d'analyse de texte fragile.
  • Fonctionne sans clé API. L'accès anonyme à 5 requêtes par minute couvre prototypage et développement. Ajoutez une clé lorsque vous passez en production.
  • Adapté au parallèle. Vérifier par lots les TLD avec Promise.all. Cinq les contrôles sont effectués en même temps qu'un seul.
  • Réponses inférieures à 200 ms. Déployé en périphérie sur Cloudflare Workers, donc la latence Le goulot d'étranglement est le serveur RDAP en amont, et non l'API elle-même.

FAQ

Ai-je besoin d'une clé API pour vérifier la disponibilité du domaine ?
Non. Le niveau gratuit permet un accès anonyme à 5 requêtes par minute avec une limitation de débit basée sur IP. Pour les contrôles par lots ou les applications de production, ajoutez une clé API à l’en-tête Autorisation pour des limites plus élevées.
Quels TLD le point de terminaison de disponibilité de domaine prend-il en charge ?
Le point de terminaison interroge les serveurs RDAP, qui couvrent tous les TLD accrédités par l'ICANN, notamment .com, .net, .org, .io, .dev, .app et des centaines de TLD de code pays. La couverture dépend du fait que l'opérateur TLD publie ou non les données RDAP.
Quelle est la précision du contrôle de disponibilité ?
Le point de terminaison interroge RDAP, le successeur officiel de WHOIS. Un 404 de RDAP signifie que le domaine n'est pas enregistré. Un 200 avec les données d'enregistrement signifie qu'il est pris. Les cas extrêmes, tels que les domaines premium ou les noms réservés au registre, peuvent apparaître comme disponibles même s'ils ne peuvent pas être enregistrés via les canaux normaux.
La réponse inclut-elle des informations WHOIS ou sur le registraire ?
Oui. Lorsqu'un domaine est enregistré, la réponse inclut le nom du bureau d'enregistrement extrait des données de l'entité RDAP. Si la réponse RDAP ne contient pas d’informations sur le registraire, le champ du registraire est omis.
Puis-je vérifier plusieurs domaines en une seule demande ?
Le point de terminaison accepte un domaine par requête. Pour les vérifications par lots, envoyez des requêtes parallèles à l'aide de Promise.all en JavaScript ou asyncio.gather en Python. L'API gère les demandes simultanées sans problème dans les limites de débit standard.

Commencez a construire avec botoi

150+ endpoints API pour la recherche, le traitement de texte, la generation d'images et les utilitaires pour developpeurs. Offre gratuite, sans carte bancaire.