Comprobar la cobertura de la tabla de asignaciones
Compruebe si un número de Norteamérica coincide con un prefijo de la tabla de asignaciones de MultiTEL y obtenga la ciudad, el estado y el país asociados. Se trata de una consulta a una tabla de prefijos. No permite determinar si un abonado está activo, si un número está asignado, si pertenece a su cuenta o si puede solicitarlo.
Solicitud
Utilice su cuenta de API habilitada y una dirección IP de origen permitida. El ejemplo utiliza credenciales de HTTP Basic obtenidas de variables de entorno y un número ficticio. No se requiere un cuerpo de solicitud.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Utilice preferentemente un número de Norteamérica de once dígitos que empiece por 1. El controlador elimina los caracteres que no sean dígitos y antepone 1 a una entrada de diez dígitos. Se rechazan las entradas con otras cantidades de dígitos. Esta normalización no valida todas las reglas de numeración de Norteamérica, por lo que una coincidencia en la tabla no constituye una validación exhaustiva del número.
Respuesta
Los valores de los campos son meramente ilustrativos; no se trata de un resultado obtenido de la tabla de asignaciones en producción.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Campo | Significado |
|---|---|
| number | Entrada normalizada que contiene únicamente dígitos. |
| npanxx | El prefijo almacenado que coincide con el número. El controlador da preferencia a un prefijo de siete dígitos de país/área/central y, si no encuentra una coincidencia, puede recurrir a un prefijo de cuatro dígitos de país/área; no dé por hecho que este campo siempre identifica una central completa. |
| city, state, country | Metadatos del prefijo de asignación coincidente. Estos campos no identifican la ubicación física actual de un abonado ni su operador actual tras una portabilidad. |
Errores
Lea el valor de JSON en el campo status.code en lugar de basarse únicamente en HTTP 200. El código de API 404 con el mensaje Not part of NANPA significa que ningún prefijo coincidió con la tabla utilizada por el servicio; no constituye un dictamen definitivo de una autoridad mundial de numeración. El código de API 500 se utiliza cuando la cantidad de dígitos no es válida o falta el número.
Coste y próximos pasos
El controlador revisado realiza una consulta local a la tabla de asignaciones y no incluye cargos en la cuenta ni consultas externas. Este controlador no aplica ninguna tarifa por consulta. Utilice la búsqueda de números disponibles para encontrar números del inventario que se puedan solicitar. Una consulta de nombre, una consulta de enrutamiento o un pedido de número son operaciones distintas, cada una con las tarifas correspondientes de su cuenta.