Documentos de la API de validación de correo electrónico
Primeros pasos
Todas las solicitudes de API requieren autenticación mediante una clave de API. Puede encontrar su clave API en el panel de control.
Cabecera: "x-api-key: tu-api-key"Verificación única
Verifique la validez, el estado desechable, los servicios de privacidad y la capacidad de entrega de una única dirección de correo electrónico o dominio.
Punto final
GET /v1/verifyParámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| input | string | Sí | Dirección de correo electrónico o dominio a verificar (por ejemplo, [email protected] o example.com) |
apiDocs.responseFields
| Campo | Descripción |
|---|---|
| valid | Indica si el formato del correo electrónico es correcto |
| block | Indica si el correo electrónico debe bloquearse (true si disposable, privacy, applePrivateEmail, deliverable o catch_all es true) |
| disposable | Determina si la dirección de correo electrónico es temporal o desechable |
| privacy | Determina si el servidor de correo está utilizando un alias o reenviador de correo electrónico. |
| applePrivateEmail | Indica si el correo electrónico es una dirección privada de Apple |
| deliverable | Comprueba si el buzón existe y puede recibir correos electrónicos |
| domain | La parte del dominio de la dirección de correo electrónico |
| email_address | La dirección de correo electrónico |
| catch_all | Indica si el dominio tiene una configuración de correo electrónico catch-all que acepta todos los correos entrantes independientemente de la dirección del destinatario. |
| mx_found | Indica si el dominio tiene servidores de correo válidos (registros MX) |
| remaining_credits | El número de créditos API restantes en su cuenta |
Ejemplo de respuesta
{
"valid": true,
"block": false,
"disposable": false,
"privacy": false,
"applePrivateEmail": false,
"deliverable": true,
"domain": "example.com",
"email_address": "[email protected]",
"catch_all": false,
"mx_found": true,
"error": null,
"remaining_credits": 99
}Ejemplos de códigos
curl "https://api.verify-email.app/v1/[email protected]" \
-H "X-API-Key: your-api-key"Pruébalo
Necesita una clave API para probar los puntos finales.
Prueba con:
Verificación de lotes
Verifique varias direcciones de correo electrónico o dominios en una sola solicitud (máx. 100 elementos).
Punto final
POST /v1/verify/batchParámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| inputs | array of strings | Sí | Conjunto de direcciones de correo electrónico o dominios para verificar |
Ejemplos de códigos
curl -X POST "https://api.verify-email.app/v1/verify/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
"inputs": [
"[email protected]",
"[email protected]"
]
}'Pruébalo
Necesita una clave API para probar los puntos finales.
Pruebe con diferentes dominios: