Integração · Apps feitos com IA
Barre e-mail falso no cadastro do seu app. Copie o prompt.
Criou o app no Lovable, no Bolt, no Cursor ou no Claude Code? Crie a chave grátis, copie o prompt e cole na sua ferramenta. Ela integra a verificação no cadastro para você.
Como funciona
Três passos, uns cinco minutos.
- 01
Crie a chave
Conta grátis no portal, sem cartão. No menu API, gere a chave e copie: ela aparece uma vez só.
- 02
Copie o prompt
O prompt abaixo diz à IA como chamar a API, o que bloquear e o que deixar passar.
- 03
Cole na ferramenta
A IA escreve a integração. Quando ela pedir, guarde a chave como segredo AUTENTIFY_API_KEY.
O prompt
Copie e cole na sua ferramenta de IA.
Bloqueia o e-mail que não existe e o temporário. Deixa passar o resto, inclusive quando a API não responde: um cadastro bom nunca fica de fora por falha nossa.
Quero validar o e-mail no cadastro do meu app com a API de verificação da Autentify, antes de criar a conta do usuário.
Regras de segurança:
- A chamada à API acontece só no servidor (rota de API, função serverless ou edge function), nunca no navegador.
- A chave fica num segredo ou variável de ambiente chamada AUTENTIFY_API_KEY. Ela não pode aparecer no código do front, no repositório nem em logs.
- Nos logs, nunca grave o e-mail completo (use, por exemplo, a***@gmail.com).
A API:
- POST https://gateway.autentify.com.br/v1/verify
- Cabeçalhos: Authorization: Bearer <AUTENTIFY_API_KEY> e Content-Type: application/json
- Corpo: {"email": "<e-mail digitado>"}
- A resposta traz "state" (deliverable, undeliverable, risky ou unknown) e, às vezes, "reason" (por exemplo mailbox_not_found, domain_not_found, no_mx ou disposable_email). Trate um reason desconhecido sem quebrar.
Como decidir no cadastro:
1. Confira primeiro o formato do e-mail no front; só chame a API quando o formato estiver certo e o usuário enviar o formulário (não a cada tecla).
2. state "undeliverable": bloqueie e mostre "Este e-mail não existe. Confira se digitou certo."
3. state "risky" com reason "disposable_email": bloqueie e mostre "Use um e-mail permanente. E-mails temporários não são aceitos."
4. state "deliverable", "unknown" ou qualquer outro "risky": deixe o cadastro seguir.
5. Se a API demorar mais de 8 segundos, responder com erro (incluindo 429, limite de consultas) ou a rede falhar: deixe o cadastro seguir e registre o erro. A verificação nunca pode impedir um cadastro por falha nossa.
6. Guarde o state junto com o usuário criado, para eu consultar depois.
Antes de terminar, me diga onde configurar o segredo AUTENTIFY_API_KEY na plataforma que estamos usando e escreva um teste para os casos 2, 3, 4 e 5 com a API simulada.Lovable
Cole no chat do projeto. Se o app usa Supabase, o Lovable cria uma edge function; guarde a chave em Supabase › Edge Functions › Secrets quando ele pedir.
Bolt
Cole no chat do projeto. A chave vai no arquivo de variáveis de ambiente do servidor, nunca numa variável pública do front.
Cursor
Cole no chat do agente com o projeto aberto. Ponha a chave no .env e confira que o .env está no .gitignore.
Claude Code
Cole no terminal, dentro da pasta do projeto. Mesma regra: chave no .env, fora do git.
Quer ver os campos todos da resposta ou validar uma lista? Está na documentação do Verify.
Perguntas frequentes
Sobre o prompt
Quanto custa?
A conta é grátis: 100 verificações por mês com e-mail da empresa, ou 20 créditos com Gmail e outros provedores gratuitos, sem cartão. Depois, 1 crédito por verificação conclusiva; inconclusivo não é cobrado. Os pacotes estão em Preços.
Por que a chamada não pode ficar no navegador?
Tudo o que roda no navegador pode ser lido por qualquer visitante. Com a chave no front, outra pessoa poderia usar os seus créditos. No servidor, a chave fica escondida.
Por que deixar passar quando a API falha?
Porque perder um cadastro bom é pior do que deixar passar um ruim de vez em quando. O prompt bloqueia só o que temos certeza: endereço que não existe e e-mail temporário.
O usuário recebe alguma mensagem?
Não. A verificação consulta o servidor do e-mail sem enviar nada. Para a pessoa, o cadastro só demora alguns segundos a mais.
Tem limite de consultas?
20 por minuto por conta, até 3 ao mesmo tempo. Para um formulário de cadastro, sobra. Acima disso a API responde 429, e o prompt já deixa o cadastro seguir nesse caso.
Funciona com outra ferramenta, como v0, Replit ou Windsurf?
Sim. O prompt descreve a API e as regras, sem depender da ferramenta. Cole onde você conversa com a IA do projeto.