Agentscan
Comprobación de email
Comprueba una dirección antes de aceptar un registro: sintaxis, dominios desechables, servidores de correo, erratas y direcciones de rol.
Comprobar una dirección de email
Parámetros
- emailstringObligatorio
La dirección a comprobar, 320 bytes como máximo. GET la toma como ?email=.
Campos de la respuesta
- emailstring
La dirección comprobada, con el dominio en minúsculas.
- statusstring
valid, invalid, risky o unknown.
- reasonstring | null
Por qué: syntax, no_mx, null_mx, disposable, typo, role, dns_error o quota. null si es valid.
- suggestionstring | null
La dirección con el dominio de webmail corregido, cuando el dominio parece una errata de uno.
- domainstring
El dominio en ASCII (IDN convertido).
- checksobject
Cada comprobación detrás del estado.
- checks.mxboolean | null
El dominio recibe correo. null si no se consultó el DNS o no respondió.
- checks.disposableboolean
El dominio da buzones desechables.
- checks.roleboolean
Un buzón compartido como info@ o support@.
- checks.freeProviderboolean
Un webmail gratuito como Gmail u Outlook.
- mailboxstring
Siempre not_checked: no se sondea el buzón.
curl -X POST https://ipscanner.io/v1/email/check \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane@outlok.com"}'{
"email": "jane@outlok.com",
"status": "risky",
"reason": "typo",
"suggestion": "jane@outlook.com",
"domain": "outlok.com",
"checks": {
"syntax": true,
"mx": true,
"disposable": false,
"role": false,
"freeProvider": false
},
"mailbox": "not_checked"
}