Sobre este vídeo

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

Transcripción del vídeo

1. 00:00Sube el archivo

   Sube un CSV a /verify/file y deja que un webhook te avise cuando termine. Bulk se queda en 50 direcciones. Para algo más grande, envía el archivo entero como datos de formulario multipart. Se aceptan CSV, TXT y XLSX. email_column nombra la columna que hay que leer. Si la omites, se detecta por ti. Este es el archivo de prueba. Cuatro filas, más una columna source que queremos conservar en los resultados. La subida no espera a las comprobaciones. Responde con un ID de tarea y un estado pending. También te dice qué columna leyó y cuántas filas y direcciones únicas encontró. Igual que la propia clave API, los trabajos de archivo son para cuentas de pago.

2. 00:43Sigue el trabajo

   Para consultarlo, haz un GET a la misma ruta añadiendo el ID de tarea. La misma cabecera, sin cuerpo. Consultado enseguida, este archivo pequeño ya estaba en la fase de merging. Mientras se ejecuta, el estado pasa por pasos como preparing, pending, processing y merging. Deja de preguntar cuando veas completed, completed with warning, failed o cancelled. Este es el trabajo terminado. Los recuentos dividen el archivo por estado: una no válida, una de rol, una catch-all y una desechable. credits_used es uno, y cache_hit_not_charged es tres. Tres filas eran recomprobaciones. Esas direcciones se comprobaron en esta cuenta en las últimas 24 horas, y una recomprobación dentro de 24 horas no se cobra. Vienen dos enlaces. download_url es la ruta estable de la API, así que es la que debes guardar. direct_download_url es un enlace de almacenamiento firmado, y deja de funcionar a la hora de caducidad indicada.

3. 01:35Obtén los resultados

   Llama a results y guarda la salida en un archivo. Sin filtros, la API redirige al archivo de resultados completo, y dash L sigue esa redirección. Tus columnas van primero, sin cambios. Después van las columnas ev_, como status, score y reason, en cada fila. ¿Necesitas solo las filas que hay que eliminar? Añade filtros. Se combinan con OR, así que esto pide no válida o desechable. Con un filtro, el CSV se genera y se devuelve directamente. Vuelven dos filas, las que hay que eliminar.

4. 02:04Usa un webhook

   El sondeo funciona, pero un trabajo largo significa muchas solicitudes. Un webhook le da la vuelta. BillionVerify llama a tu servidor cuando un trabajo de archivo termina o falla. Registra uno con un POST a /webhooks. Dale una URL HTTPS y los eventos que quieras. Hay dos: file.completed y file.failed. Esa respuesta lleva un secreto de firma, y es la única vez que lo verás. Guárdalo enseguida. Lo necesitas para comprobar cada entrega. Cada entrega es un POST JSON con tres cabeceras: el evento, una marca de tiempo y una firma. El cuerpo nombra el evento y la hora. Su data lleva el ID del trabajo, los recuentos, los créditos usados y los enlaces de descarga.

5. 02:44Comprueba la firma

   Comprueba la firma antes de actuar sobre una entrega. Une la cabecera de la marca de tiempo, un punto y el cuerpo sin procesar. Aplica HMAC-SHA256 con tu secreto y compara con la cabecera de la firma. Calcula el hash del cuerpo exactamente como llegó. Un JSON analizado y vuelto a codificar no coincidirá. Y rechaza las marcas de tiempo antiguas, para que no se pueda repetir una solicitud vieja. Así que todo el flujo es corto. Subir, guardar el ID de tarea, esperar al webhook y luego obtener los resultados desde el enlace estable.

6. 03:11Siguientes pasos

   Los valores de estado, los filtros y cada campo del webhook están en la referencia de la API, en billionverify.com/docs/api-reference. 20 créditos gratis cada día que usas tu cuenta, hasta 600 al mes. Sin tarjeta de crédito. Empieza en billionverify.com.