# IaGenify SDK 0.3.3: descubra extensões de domínio disponíveis pela API.

Canonical URL: https://www.iagenify.com/pt/news/iagenify-sdk-033-domain-extension-discovery

O SDK consulta o catálogo atual do registrador conectado e pesquisa nomes nos TLDs escolhidos, sem manter uma lista fixa que logo fica desatualizada.

## Key points
- `api.domains.tlds()` lê as extensões do registrador conectado ao IaGenify.
- `api.domains.search()` aceita extensões escolhidas ou um domínio completo.
- A busca verifica disponibilidade; não reserva o nome nem significa que o SDK faz a compra.

Uma interface de busca de domínios costuma começar com uma lista fixa de extensões conhecidas. Essa lista se torna enganosa quando o registrador oferece outras opções, altera o catálogo ou não consegue confirmar um resultado. O IaGenify SDK 0.3.3 acrescenta uma forma direta de descobrir as extensões oferecidas pelo registrador conectado.

## Pergunte à API o que é aceito hoje

O novo método `api.domains.tlds()` lê o catálogo disponível no serviço. O aplicativo pode usá-lo para montar filtros, diretórios ou sugestões, em vez de enviar uma lista fixa que diverge da cobertura real do provedor.


```
const extensions = await api.domains.tlds();
const results = await api.domains.search("studio", {
  tlds: ["com", "design", "studio"],
});
```

## Pesquise uma extensão ou compare várias

A busca aceita um nome e uma lista opcional de extensões. É possível consultar um domínio completo ou pesquisar um nome curto em várias extensões e comparar resultados. Catálogo e busca podem alimentar tanto um campo simples quanto uma tabela comparativa.

## Disponibilidade não é reserva

O resultado mostra a disponibilidade no momento da consulta. Ele não reserva o nome, não conclui o registro e não garante o mesmo resultado mais tarde. O SDK mantém essa fronteira clara: permite descobrir e pesquisar; registro e pagamento ficam em um fluxo explícito do IaGenify.

Essa distinção importa na interface. Disponibilidade desconhecida deve continuar desconhecida, e um resultado positivo não deve parecer uma confirmação de compra. O aplicativo mostra a resposta do provedor, enquanto o pedido fica para uma etapa separada e confirmada.

> Use o catálogo atual do registrador na interface; deixe o fluxo de pedido concluir a compra.

Com a versão 0.3.3, aplicativos com domínios podem montar suas opções a partir do mesmo serviço que consultam. É uma pequena mudança que reduz suposições antigas e separa a busca de um nome do seu registro.

## FAQ
### `api.domains.tlds()` contém uma lista embutida no SDK?
Não. O método lê o catálogo da API IaGenify conectada ao registrador.

### Posso pesquisar um domínio completo?
Sim. `api.domains.search()` aceita um domínio completo ou um nome-base com extensões.

### Um resultado disponível reserva o domínio?
Não. Ele informa a disponibilidade naquele momento; não reserva nem registra o nome.

### Esse método permite comprar?
Não. Ele consulta o catálogo e pesquisa nomes. Registro e pagamento exigem um fluxo separado e confirmado.