Consulta del operador internacional: verificación de números en varios países
Cómo realizar una consulta del operador internacional en números de varios países: formato, comprobaciones múltiples síncronas, archivos masivos y notas regionales.
Una guía práctica para realizar una consulta del operador internacional en listas de teléfonos de varios países, desde el formato E.164 hasta la elección entre comprobaciones en tiempo real y archivos masivos.
La consulta del operador internacional funciona mejor cuando cada número está escrito en formato E.164, con un signo más inicial, el código de país y el número de suscriptor. CarrierLookup devuelve el operador al que se asignó originalmente cada número, además del tipo de línea y la geografía de asignación. Las comprobaciones en tiempo real aceptan números de diferentes países en una sola solicitud, mientras que las tareas de archivos masivos se estructuran en torno a un país seleccionado por archivo. El resultado es el contexto de la asignación original, no la red que presta servicio al número en la actualidad.
Comience con una entrada E.164 limpia
Toda consulta del operador internacional depende de que el código de país esté presente. El formato E.164 comienza con un signo más, seguido del código de país y el número de suscriptor, sin espacios, guiones ni corchetes. Una cadena de formato nacional, como un número que comienza con un cero de prefijo troncal, no puede situarse en un país sin realizar suposiciones, por lo que debe convertirse antes de la consulta.
Una lista de verificación rápida para una lista mixta:
- Añada el signo más y el código de país a cada fila.
- Elimine espacios, puntuación y texto de extensión.
- Descarte los marcadores de posición obvios y las filas en blanco.
- Conserve la columna de origen original para poder rastrear las filas rechazadas.
Un formato rechazado no es un resultado de "sin operador". Solo significa que la entrada no pudo leerse como un número, por lo que debe corregir el formato y ejecutarlo de nuevo.
Comprobación de listas de varios países en tiempo real
La Consulta del operador original en tiempo real no solicita una selección de país por separado, porque el código de país dentro de cada número ya lo incluye. Un solo número se procesa a través de POST /api/v1/check, y una solicitud múltiple síncrona se procesa a través de POST /api/v1/batch-check con entre 1 y 100 números, incluso cuando provienen de diferentes países. Los resultados se devuelven en el orden de entrada, por lo que pueden compararse con las filas de origen según su posición.
El panel de control ofrece la misma consulta múltiple en tiempo real para hasta 500 números a la vez, lo cual es adecuado para un analista que tiene una lista pegada y desea obtener respuestas en pantalla.
En una respuesta múltiple, cada elemento informa si existe un resultado normal. La ausencia de un resultado normal no es una declaración de que el número sea inválido o esté desconectado. Si una solicitud múltiple agota el tiempo de espera, toda la solicitud falla sin resultados parciales y se devuelve el importe total.
Cuándo cambiar a una tarea de archivo masivo
Las tareas de archivo masivo son asíncronas y se adaptan a listas grandes. Una tarea requiere un archivo TXT o CSV con un número con código de país por línea y un país ISO seleccionado. Debido a que la tarea está limitada a un país, una lista global debe dividirse primero por país y luego enviarse como tareas separadas.
El preprocesamiento excluye las filas inválidas, los duplicados, los números sin código de país y los números fuera del país seleccionado. Las filas excluidas no se cobran. Una tarea pasa por los estados de procesamiento, éxito o fallo, y una tarea exitosa devuelve un archivo CSV descargable. Consulte el estado de la tarea con una frecuencia no superior a 30 segundos.
Se aplican límites por producto al tamaño del archivo y al recuento de números, por lo que debe consultar la documentación actual de la API antes de planificar una carga muy grande.
Notas regionales y significado de los resultados
La cobertura no es idéntica en todas partes. Las comprobaciones de un solo número en tiempo real admiten China continental (+86), Hong Kong (+852) y Macao (+853) para volúmenes pequeños, mientras que las tareas de archivos masivos no admiten estas regiones. La compatibilidad con Taiwán (+886) no está confirmada, por lo que debe probar una pequeña muestra antes de incluirla en un plan.
Una forma rápida de elegir una ruta:
| Situación | Ruta sugerida |
|---|---|
| Unos pocos números de muchos países | Comprobación única o múltiple en tiempo real |
| Una lista pegada por el equipo | Consulta múltiple en el panel de control |
| Una lista grande de un solo país | Tarea de archivo masivo |
| China continental, Hong Kong o Macao | Solo comprobaciones únicas en tiempo real |
Al leer los resultados, trate al operador como la asignación original, y a la región y la ciudad como la geografía del rango numérico. Ninguno de estos datos describe dónde se encuentra una persona, ni establece que un número pueda recibir llamadas o mensajes.
Preguntas frecuentes
¿Puede una solicitud contener números de varios países?
Sí, para las solicitudes múltiples síncronas. Una solicitud múltiple acepta de 1 a 100 números E.164, y pueden provenir de diferentes países. Las tareas de archivos masivos son diferentes, ya que cada tarea se basa en un país seleccionado, por lo que una lista global debe dividirse antes de enviarla.
¿Cómo pueden los equipos gestionar los números que no devuelven un resultado normal?
Manténgalos en una lista de revisión separada. Los equipos pueden volver a comprobar el formato, confirmar el origen del número y tratar la columna del operador como desconocida en lugar de negativa.
¿Muestra la consulta del operador internacional la red actual?
No. CarrierLookup informa del operador al que se asignó originalmente un rango numérico. Después de que un número se transfiere a otra red, el operador original sigue siendo el mismo. El resultado es útil para la segmentación y el enriquecimiento de datos, no para decidir qué red presta servicio a un número actualmente.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.