Sobre este vídeo

Las respuestas de este vídeo son respuestas reales de la API, abreviadas. Las claves API y la verificación masiva y de archivos requieren una cuenta de pago.

Transcripción del vídeo

1. 00:00Tu primera solicitud

   Tu primera solicitud es un POST a /verify/single. Envía un campo JSON, email. Pon tu clave API en la cabecera BV-API-KEY. Esa es toda la solicitud. Guarda esa clave en una variable de entorno de tu servidor, nunca en código de cliente. Crear una clave requiere una cuenta de pago, y cualquier compra de créditos la desbloquea.

2. 00:24Lee la respuesta

   Esta es la respuesta real para una dirección de soporte. Empieza por status. Dice role, porque support es el nombre de un buzón compartido, no de una persona. El score es 0,6. Es un valor sacado de reglas fijas, no una probabilidad. Así que decide según status, no según el score. is_deliverable es true, así que el servidor de correo aceptó esta dirección. is_catch_all también es true, así que este dominio acepta cualquier dirección. Role se queda con el estado, y los indicadores muestran el resto. reason da el porqué, como un código. Aquí es catch-all deliverable.

3. 01:02Por qué credits_used es 0

   La documentación tiene una página que lista todos los códigos. Ahora credits_used. Aquí es cero, pero eso no significa que las comprobaciones sean gratis. Esta cuenta ya comprobó esta dirección en las últimas 24 horas, así que la repetición no se cobró. Una primera comprobación como esta cuesta un crédito. verification_mode dice de dónde vino la respuesta. Esta vino del historial en caché. Úsalo para entender el resultado. Para la facturación, lee credits_used.

4. 01:23Hasta 50 direcciones

   ¿Tienes una lista corta? Usa /verify/bulk. La cabecera es la misma, y el cuerpo lleva un array emails, de hasta 50 direcciones. Los resultados vuelven en esta misma respuesta. Cada dirección recibe los mismos campos que acabas de ver. La primera es catch-all. La segunda es inválida, porque ese buzón no existe. La tercera es desechable. Las tres usaron un crédito. La inválida cuenta. La desechable cuenta aquí porque esta solicitud puso check_smtp en true. Si lo omites, una coincidencia desechable se detiene pronto, sin cargo. Así que, por defecto, desconocida, sintaxis incorrecta y desechable no cuestan nada. Todo lo demás es un crédito, catch-all y rol incluidos. Debajo de los resultados hay totales. Los correos válidos son cero, porque catch-all no se cuenta como válida. Y los grupos clasifican el lote: uno utilizable con catch-all, dos no entregables. Si envías más de 50, recibes un HTTP 400 con el código 3103. La lista no se divide por ti, y tampoco se convierte en un trabajo de archivo. El error te remite al endpoint de archivos.

5. 02:28Listas más grandes

   Para listas más grandes, sube un archivo. Es asíncrono, así que la subida te da un ID de trabajo. Usa ese ID para consultar el progreso. Cuando el trabajo termina, descarga los resultados. Conserva la opción -L, porque la descarga puede redirigir. La descarga es un CSV. Tus columnas originales se mantienen y las nuevas van detrás, como ev_status y ev_reason.

6. 02:49Consulta tus créditos

   /credits te dice lo que queda. Es un GET, con la misma cabecera. Consúltalo antes de una subida grande, porque sin créditos suficientes la API devuelve un 402.

7. 03:00Dos opciones de solicitud

   Dos opciones cambian lo que hace una comprobación. SMTP está activado por defecto, y nunca se envía ningún correo. check_smtp false se salta el servidor de correo, así que la mayoría de las direcciones vuelven como desconocida. force_refresh true se salta la caché, y pagas por el resultado nuevo.

8. 03:17Errores y límites

   Gestiona primero tres errores. 401 es una clave ausente o no válida. 402 significa créditos insuficientes. 429 es un límite de tasa, así que espera un momento y reintenta. Los límites de tasa se aplican por clave API. 6.000 solicitudes por minuto en single. 1.500 en bulk.

9. 03:37Siguientes pasos

   300 en subidas de archivos. Ese es el inicio rápido. Single, bulk, archivo y créditos. La referencia completa de la API, los SDK y los webhooks están en billionverify.com/docs. 20 créditos gratis cada día que usas tu cuenta, hasta 600 al mes. Sin tarjeta de crédito. Empieza en billionverify.com.

Aparece en este vídeo