API V2
La versión 2 de la API Captain Verify ya está disponible e incluye nuevas funciones. Si está buscando una forma confiable de verificar la validez de sus correos electrónicos, puede integrar la API de verificación de correo electrónico de Captain Verify en sus propias aplicaciones. Aconsejamos utilizar la API a posteriori porque una verificación puede ser más o menos larga (1 minuto).
Clave API
Se requiere una cuenta para generar la clave para la API, esto es lo que le dará acceso al servicio.
Límites de API
La API está limitada a un máximo de 2 conexiones simultáneas y 50 comprobaciones por minuto. Al integrar la API, asegúrese de que su aplicación no exceda este límite.
La solicitud
Para realizar una solicitud a la API, simplemente llame al protocolo GET en esta URL:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Reemplace john.doe@gmail.com con su correo electrónico para verificar.
La respuesta
Se devolverá una tabla json con estas variables:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok_for_all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
Variables | valor posible |
---|---|
credits | Créditos disponibles en su cuenta. |
result | valid, invalid, risky, unknown El estado del correo electrónico. si se han agotado todos sus créditos, siempre se devolverá el estado desconocido, para no bloquear su aplicación. |
details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Comprender el resultado de una auditoría. |
free | true, false Si el proveedor de correo electrónico es gratuito, por ejemplo, Gmail.com. |
role | true, false Si el usuario de correo electrónico tiene un rol, por ejemplo: support@example.com. |
disposable | true, false El correo electrónico es válido, pero desechable después de un corto tiempo ya no será posible contactar al usuario. |
ok_for_all | true, false Ok para todos: el servidor de correo remoto acepta todos los correos electrónicos (catch-all). |
protected | true, false El correo electrónico está protegido por una solución antispam patentada |
mailboxfull | true, false La dirección de correo electrónico está llena. Ya no puede recibir correo |
did_you_mean | default : null Si, por ejemplo, el correo electrónico es john.doe@gmil.com, la API le enviará una propuesta como john.doe@gmail.com. |
El correo electrónico que desea verificar. | |
email_normalized | El correo electrónico se ha normalizado, eliminando etiquetas para gmail... support+test@gmail.com será support@gmail.com. |
success | true, false Si la autenticación falla, sus créditos están agotados. |
message | default : null Cuando el éxito sea falso, se enviará un mensaje de error. |