Consultar información de enrutamiento
Solicite información de enrutamiento de un número de teléfono de América del Norte. Utilícela para interpretar los datos disponibles de enrutamiento y del operador, no como prueba de la identidad del abonado, de la titularidad del número, de que sea posible contactar con él ni de su disponibilidad para comprarlo. Una consulta puede generar un cargo en su cuenta.
Solicitud
Utilice su cuenta de API habilitada y la dirección IP de origen permitida para ella. Proporcione el número completo en dígitos, incluido el código de país 1. El ejemplo utiliza variables de entorno y un número ficticio. El componente que procesa la solicitud no normaliza los signos de puntuación; valide los datos de entrada antes de enviarlos.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123Respuesta
Solo se muestra una selección de campos a modo de ejemplo; su disponibilidad depende de la fuente y del tipo de número.
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}La consulta estándar convierte a minúsculas los nombres de los campos devueltos. Según la fuente, puede haber campos de operador, centro de tarificación, ubicación y jurisdicción. La respuesta no es una ficha completa del abonado con una estructura fija. El indicador local puede tener el valor numérico 1 o el valor de cadena 0. El componente que procesa la solicitud calcula ported comparando el número de enrutamiento devuelto con el número de teléfono proporcionado; no lo interprete como un historial completo y verificado de portabilidad.
Precio y reintentos
El componente revisado que procesa la solicitud aplica un débito de $0.00025 a la cuenta cuando alcanza su ruta de finalización y registra la consulta. El coste devuelto normalmente es una cadena que incluye el signo de dólar, en lugar de un importe meramente numérico. No se ofrece ninguna clave de idempotencia. Repetir una solicitud puede generar otro cargo.
Para las cuentas de prepago, el código comprueba que el saldo sea de al menos 0.00025. Su mensaje de saldo insuficiente menciona actualmente $5, lo que no coincide con ese umbral. Interprete el fallo como un rechazo por saldo y compruebe los fondos de la cuenta antes de volver a intentarlo.
Fallos y resultados satisfactorios incompletos
Consulte tanto el estado HTTP como los campos status.code/status.msg de JSON. Un resultado vacío de una consulta estándar devuelve el código 404 de la API. El código 403 de la API puede indicar un saldo de prepago insuficiente.
Una de las rutas de error actuales para números gratuitos puede aun así cargar el importe de la consulta y devolver el código 200 de la API sin campos de enrutamiento útiles; la información sobre su coste puede estar incompleta. Por lo tanto, un código 200 por sí solo no demuestra que la consulta sea utilizable. Valide los campos que necesita su aplicación, contraste los cargos dudosos con los registros de facturación de la cuenta y póngase en contacto con el servicio de asistencia si los resultados están incompletos.
En la implementación revisada, el tratamiento de los números gratuitos varía según la longitud de los datos de entrada. Utilice preferentemente todos los dígitos del número en formato internacional y confirme con el servicio de asistencia la cobertura necesaria para números gratuitos. No reintente automáticamente una consulta cuyo resultado tenga un formato incorrecto o esté incompleto, ni se base en una consulta de enrutamiento para decidir que es seguro llamar a un número o que tiene autorización para hacerlo.