Email Validator: Disposable
Verificar descartável
Diz em milissegundos se um endereço ou domínio é descartável ou de alto risco, para você bloquear cadastros falsos. Não conversa com o servidor da caixa de email: para isso, use Validate Email.
https://g.sendcorex.com/v1/tool/validatecommand: check_disposableRequer o escopo tools:validate na sua API key.
Usa 1 crédito de disposable (não um crédito de validação). Planos ilimitados nunca são cobrados.
Envie email ou domain. Com um email, a reputação de fraude do endereço também é verificada.
Argumentos
emailstringopcionalO endereço a verificar. Até 254 caracteres.
ex.:
"john@mailinator.com"domainstringopcionalSó o domínio, quando você não tem o endereço completo.
ex.:
"mailinator.com"
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "check_disposable",
args: {
email: "john@mailinator.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "check_disposable",
"id": "0",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"email": "john@mailinator.com",
"domain": "mailinator.com",
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"unlimited": false,
"remaining_credits": 4999
}
}
]
}Campos da resposta
emailO endereço que você enviou, sem espaços e em minúsculas.
nullquando você enviou só umdomain.domainO domínio que foi verificado.
is_disposabletruepara provedores temporários/descartáveis. Bloqueie o cadastro.high_risktruequando o endereço é descartável OU já foi marcado por fraude na Sendcorex. Bloqueie ou mande para revisão.codefully_confirmedquando algo foi encontrado,clearquando nada foi.reasonUma explicação curta do veredito.
checksAs verificações que rodaram (
check,status,details). Veja Verificações abaixo.remaining_creditsCréditos de disposable restantes após esta verificação.
nullem um plano ilimitado.unlimitedtrueem um plano ilimitado.
Verificações
Da mais barata para a mais lenta. Um domínio na blocklist responde na hora, sem nenhuma consulta DNS.
Email Reputation CheckSó aparece quando falha: o endereço foi marcado por fraude na Sendcorex. Define
high_risk, nãois_disposable.Domain Blocklist MatchO domínio é um provedor descartável conhecido. Quando falha, nada mais roda: a resposta volta na hora.
MX Record CheckO domínio está hospedado em infraestrutura usada por provedores descartáveis, mesmo que ainda não esteja em nenhuma lista.
MX Record PresentInformativa: o domínio tem registros MX. Um domínio sem MX não pode receber email (geralmente um erro de digitação), mas isso sozinho não o torna descartável.
Usando o resultado
Formulários de cadastroChame antes de criar a conta. Quando
is_disposablefortrue, peça outro endereço.Alto riscohigh_risksemis_disposableé uma caixa real marcada por fraude na Sendcorex. Bloqueie ou segure a conta para revisão.Disposable vs. Validate EmailEsta verificação é instantânea e barata. Validate Email também pergunta ao servidor da caixa se o endereço existe, o que leva segundos: use-o antes de enviar.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 75 requisições/s ou 75 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem `tools:validate`.
- CMD
INVALID_ARGSUm argumento é inválido: email ausente (ou domínio, em `check_disposable`), mais de 50 emails, um endereço com mais de 254 caracteres, limit fora do intervalo…
- CMD
INSUFFICIENT_CREDITSVocê não tem créditos suficientes para o comando inteiro (créditos de validação para `validate_*`, créditos de disposable para `check_disposable`). Nada foi verificado e nada foi cobrado.
- CMD
CREDITS_UNAVAILABLENão foi possível ler seus créditos agora. Nada foi cobrado. Tente de novo.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.