Pular para o conteúdo
Tutorial

Verifique a disponibilidade do domínio com uma chamada de API

| 5 min read

POST um nome de domínio, obtenha um booleano de disponibilidade e dados de registrador em menos de 200 ms. Crie UIs de pesquisa de domínio em tempo real, verifique TLDs em lote e sugira nomes de forma programática.

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

Você está criando um fluxo de integração SaaS que sugere domínios personalizados para novos espaços de trabalho. O usuário digita "acme" e sua IU precisa verificar acme.com, acme.io, acme.dev em tempo real. APIs de registrador cobrar por pesquisa, exigir fluxos de trabalho de aprovação e impor limites de taxas rígidos. Você precisa de um verificação de disponibilidade leve que retorna um booleano e sai do caminho.

O botoi /v1/domain/availability endpoint faz uma coisa: informa se um domínio está registrado. POSTAR um nome de domínio e voltar available, registerede o nome do registrador, se existir. Sem conta de registrador, sem análise de WHOIS, sem raspagem.

A chamada da API

Quando um domínio está disponível:

Quando um domínio é adquirido:

A resposta é mínima propositalmente. available é o booleano no qual você ramificará. registered é o seu inverso, incluído para facilitar a leitura. Quando o domínio é adquirido, o registrar campo mostra quem o detém. O endpoint consulta o RDAP (o WHOIS oficial sucessor), portanto os dados são oficiais.

UI de pesquisa de domínio em tempo real

Para uma experiência de pesquisa enquanto você digita, descarte a entrada e cancele solicitações obsoletas com um AbortController. Um atraso de 300 ms evita o disparo a cada pressionamento de tecla, mantendo o UI responsiva.

A lógica de aborto é importante. Sem ele, uma resposta lenta para "acm" pode substituir o resultado de "acme" se as solicitações forem resolvidas fora de ordem. O AbortController te garante sempre exiba o resultado da entrada mais recente.

Verifique em lote vários TLDs

A maioria das ferramentas de pesquisa de domínio verifica vários TLDs ao mesmo tempo. Disparar solicitações paralelas com Promise.all e mostrar os resultados como uma grade.

Cinco solicitações paralelas são concluídas no tempo de uma solicitação sequencial. No nível gratuito (5 req/min, 100 req/dia), funciona para desenvolvimento e demonstrações. Para produção, adicione uma chave API para remover limites de taxa.

Recurso de sugestão de domínio Node.js

Um mecanismo de sugestão de domínio gera candidatos combinando a palavra-chave do usuário com palavras-chave comuns. prefixos e TLDs e, em seguida, filtra o que está disponível. Aqui está uma função completa que você pode descartar em um back-end Express ou Hono.

Isso verifica 12 candidatos em paralelo (4 prefixos x 3 TLDs). A função retorna apenas disponível domínios, para que seu frontend possa renderizá-los como sugestões sem qualquer filtragem extra.

Endpoint expresso para um fluxo de integração SaaS

Conecte a verificação em lote a uma rota Express que seu front-end chama durante a criação do espaço de trabalho. O back-end lida com a chave da API, portanto ela nunca chega ao cliente.

Seus POSTs de front-end {"{ name: \"acme\" }"} e recebe de volta uma lista de domínios com estado de disponibilidade. A partir daí, renderize os indicadores verdes/vermelhos e deixe o usuário escolher.

Pontos-chave

  • Um ponto final, um propósito. PUBLICAR /v1/domain/availability com um domain campo. A resposta informa se está registrado, quem é o registrador e nada mais.
  • Apoiado por RDAP. O endpoint consulta o RDAP, o substituto sancionado pela ICANN para QUEM. Sem raspagem de tela, sem análise de texto frágil.
  • Funciona sem uma chave API. O acesso anônimo a 5 solicitações por minuto cobre prototipagem e desenvolvimento. Adicione uma chave quando for para a produção.
  • Compatível com paralelo. Verifique TLDs em lote com Promise.all. Cinco as verificações são concluídas no mesmo horário de uma.
  • Respostas abaixo de 200 ms. Implantado na borda em Cloudflare Workers, portanto a latência o gargalo é o servidor RDAP upstream, não a API em si.

FAQ

Preciso de uma chave de API para verificar a disponibilidade do domínio?
Não. O nível gratuito permite acesso anônimo a 5 solicitações por minuto com limitação de taxa baseada em IP. Para verificações em lote ou aplicativos de produção, adicione uma chave de API ao cabeçalho de autorização para limites mais altos.
Quais TLDs o endpoint de disponibilidade de domínio suporta?
O endpoint consulta servidores RDAP, que cobrem todos os TLDs credenciados pela ICANN, incluindo .com, .net, .org, .io, .dev, .app e centenas de TLDs com código de país. A cobertura depende se o operador TLD publica dados RDAP.
Quão precisa é a verificação de disponibilidade?
O endpoint consulta o RDAP, o sucessor oficial do WHOIS. Um 404 do RDAP significa que o domínio não está registrado. Um 200 com dados cadastrais significa que foi levado. Casos extremos, como domínios premium ou nomes reservados pelo registro, podem aparecer como disponíveis, mesmo que não possam ser registrados por meio de canais normais.
A resposta inclui informações WHOIS ou de registrador?
Sim. Quando um domínio é registrado, a resposta inclui o nome do registrador extraído dos dados da entidade RDAP. Se a resposta RDAP não contiver informações do registrador, o campo do registrador será omitido.
Posso verificar vários domínios em uma única solicitação?
O endpoint aceita um domínio por solicitação. Para verificações em lote, envie solicitações paralelas usando Promise.all em JavaScript ou asyncio.gather em Python. A API lida com solicitações simultâneas sem problemas nos limites de taxa padrão.

Comece a construir com botoi

150+ endpoints de API para consultas, processamento de texto, geração de imagens e utilitários para desenvolvedores. Plano gratuito, sem cartão de crédito.

Ver documentação da API Ver todas as ferramentas