Detección en tiempo real

La detección en tiempo real responde de inmediato una pregunta sobre un identificador: ¿este número de teléfono — o esta dirección de correo — está registrado en una plataforma determinada?

El motor es el mismo que usa la consola. Acepta un número de teléfono o una dirección de correo, lo verifica contra entre uno y diez productos en tiempo real y devuelve un veredicto por producto.

Cuándo usarla

Tienes	Usa
Un identificador, o unos pocos, y necesitas la respuesta ahora	Tiempo real
Miles de identificadores, y puedes esperar	Detección masiva

Los casos típicos en tiempo real son la validación de formularios en el registro o el pago, consultas puntuales dentro de una herramienta interna y una pequeña cantidad de verificaciones dentro de un flujo ya en ejecución. El modo masivo está pensado para archivos y arreglos grandes: es asíncrono, se cobra por fila verificada y las tareas terminadas se pueden descargar.

Dos series, un contrato

La serie se indica en la ruta y debe coincidir con los productos que seleccionas:

Serie	Endpoint	identifier
Teléfono	POST /v1/realtime/check/phone	Número E.164, por ejemplo +8613800138000
Correo	POST /v1/realtime/check/email	Dirección de correo, por ejemplo user@example.com

Una solicitud no puede mezclar series: seleccionar un producto de teléfono y uno de correo en la misma llamada se rechaza. country es opcional para un número E.164 completo y debe omitirse para correo.

Cómo se cuenta una llamada

Una llamada toma un identificador y entre uno y diez productos:

• un request_id para la llamada
• una entrada por producto en results
• un cobro por entrada

Como cada entrada se cobra por separado, una llamada puede tener éxito para algunos productos y fallar para otros. Eso se informa como status: partial_succeeded, y cada entrada lleva su propio billing_status — léelos en lugar de confiar solo en el HTTP 200.

Las páginas de esta sección

• Verificación en tiempo real de teléfono — el endpoint de teléfono completo
• Verificación en tiempo real de correo — el endpoint de correo completo
• Productos en tiempo real — la lista actualizada de productos que puedes seleccionar y cómo leer un ID de ella
• Idempotencia y reintentos — por qué Idempotency-Key es obligatorio y cómo se comportan los reintentos
• Facturación y reembolsos — qué se cobra, qué se reembolsa y cuándo
• Ejemplos de cURL / SDK — llamadas listas para copiar en los casos comunes

Antes de hacer la primera llamada

1. Ten una clave de API — consulta Autenticación.
2. Lee de Productos en tiempo real los IDs de producto que piensas usar.
3. Envía un Idempotency-Key único en cada llamada; es obligatorio, no opcional.