Cómo consulta CarrierLookup el operador de un número

Complete una verificación

Esta sección trata las verificaciones en tiempo real: el panel SaaS y los endpoints REST síncronos comparten un mismo servicio de verificación y un mismo significado de respuesta. Para listas muy grandes existe una opción masiva asíncrona, que se explica al final de esta página.

1. 1

   Envíe un número

   Envíe un número completo, tal como se describe en la documentación de la API.

2. 2

   Use service_type=carrier

   El producto carrier devuelve la red a la que se asignó originalmente el número, con el tipo de línea y la región de asignación.

3. 3

   Lea el resultado

   Lea los campos del operador en la misma respuesta. Describen la asignación original, no el operador que da servicio al número hoy.

Qué formato de número enviar

CarrierLookup acepta un número por consulta, escrito en formato E.164: un signo más, el código de país y, a continuación, el número de abonado sin espacios ni separadores.

• Envíe el número completo, incluido el código de país. Un número nacional sin él no se puede consultar.
• No se aceptan formatos nacionales con ceros iniciales, espacios, guiones o paréntesis; envíe solo el + y los dígitos.
• Los números con un formato incorrecto se rechazan antes de cualquier cargo; un formato rechazado no es una respuesta de «sin resultado».

¿Qué significan los campos del operador?

Los campos del operador son la respuesta de una consulta de operador: carrier, underlying_carrier, number_type, country_code, region y city, en el nivel superior de una respuesta correcta. Contienen el operador y el tipo de línea asignados originalmente, el país y la región y ciudad de asignación cuando el proveedor los facilita. No hay un indicador registered: una respuesta correcta es el resultado. Cualquier otro desenlace (un tiempo de espera agotado, un resultado indeterminado, un número no válido) se devuelve como código de error, y esa consulta se reembolsa automáticamente. Un valor vacío nunca significa «sin operador»; significa que el proveedor no facilitó ese campo.

• carrier es la red a la que se asignó el número cuando se emitió.
• number_type, region y city pueden estar vacíos cuando el proveedor no los facilita; las claves siempre están presentes.
• Gestione los demás desenlaces según el código de respuesta de la API; no deduzca la asignación por su cuenta.

Use el resultado dentro de su alcance

Un resultado de operador describe la red a la que se asignó originalmente el número. No es una comprobación de disponibilidad, ni una verificación de identidad, ni un permiso para contactar con alguien.

• No confirma quién es el titular del número ni sigue la portabilidad numérica: un número portado sigue indicando el operador al que se asignó originalmente su rango.
• Un resultado de operador no establece el consentimiento para contactar con el número.
• No trate el resultado como el operador actual: volver a consultar el número devuelve la misma asignación original, no la red a la que pueda haberse portado.

Listas muy grandes: la opción asíncrona

La verificación múltiple del panel y el endpoint múltiple de la API cubren la mayoría de las listas. Solo cuando una lista supera con creces esos límites tiene sentido enviar el archivo completo como una tarea masiva asíncrona.

• Suba un .txt o .csv con un número por línea, desde la página de verificación masiva o a través de la API.
• Al subirlo, elija el país al que pertenecen los números; cada línea debe seguir estando en formato E.164.
• Al enviar, se reserva saldo para las líneas válidas, solo se le cobran los números que devuelven un resultado y la diferencia se reembolsa.
• La tarea se ejecuta en segundo plano; descargue el archivo de resultados cuando termine. Una tarea fallida se reembolsa íntegramente.