Pular para o conteúdo

Verificar um endereço

POST
/email-validations
curl --request POST \
"https://api.iporto.com.br/api/external/v1/email-validations" \
--header "Authorization: Bearer $IPORTO_API_KEY" \
--header "Content-Type: application/json" \
--data '{"email":"[email protected]"}'

Verifica um endereço na hora e devolve o resultado na resposta.

⚠️ Tem teto de requisições por minuto, por conta: a verificação abre conexão com o servidor de destino, e um laço sem limite vira uma enxurrada de conexões saindo do nosso IP — que é como um IP entra em lista negra.

Para muitos endereços de uma vez, use os lotes: eles custam uma requisição só.

Media typeapplication/json
object
email
required
string
<= 320 characters
Examplegenerated
{
"email": "example"
}

O resultado da verificação.

Media typeapplication/json

O mesmo objeto que a tela do Validador consome. ⚠️ Os sinalizadores de result são TRI-ESTADO: true, false ou null — e null significa que o motor não soube, nunca “não”.

object
object
string
nullable
id
string
nullable
batch_id
string
nullable
email
string
nullable
status
string
nullable
send
object
status
string
nullable
label
string
nullable
reasons
Array
result
object
valid
boolean
disposable
boolean
gibberish
boolean
typing_error
boolean
trap
boolean
abandoned
boolean
free
boolean
role
boolean
name
boolean
bank
boolean
gov
boolean
catch_all
boolean
domain
object
name
string
nullable
mx
string
nullable
diagnostic
object
smtp_response
string
nullable
line
object
number
integer
content
string
nullable
credits_charged
integer
checked_at
string
nullable
created_at
string
nullable
expires_at
string
nullable
Examplegenerated
{
"object": "example",
"id": "example",
"batch_id": "example",
"email": "example",
"status": "example",
"send": {
"status": "example",
"label": "example",
"reasons": [
"example"
]
},
"result": {
"valid": true,
"disposable": true,
"gibberish": true,
"typing_error": true,
"trap": true,
"abandoned": true,
"free": true,
"role": true,
"name": true,
"bank": true,
"gov": true,
"catch_all": true
},
"domain": {
"name": "example",
"mx": "example"
},
"diagnostic": {
"smtp_response": "example"
},
"line": {
"number": 1,
"content": "example"
},
"credits_charged": 1,
"checked_at": "example",
"created_at": "example",
"expires_at": "example"
}

A chave não foi enviada, ou venceu.

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}

Sem crédito. O pedido está correto — o que falta é saldo, e por isso não é 422.

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}

O corpo não traz email, ou ele não é texto.

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}

Acima do teto de verificações por minuto desta conta.

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}

Não foi possível consultar o saldo. Não quer dizer que falta crédito: quer dizer que não conseguimos perguntar. Tente de novo.

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}