Comprobar el inventario móvil para una central

Elegir un prefijo compatible

Utilice un prefijo móvil individual actual obtenido del descubrimiento. Este punto de conexión está destinado a centrales NANPA: un NPA identifica el código de área y un NXX identifica la central. Un prefijo con solo el código de área es demasiado amplio. No envíe identificadores de visualización agrupados ni infiera compatibilidad con otro país porque su prefijo contenga suficientes dígitos.

Usar el recuento como indicación

Lea response.count, con response.npa y response.nxx que identifica la central. Esta es la instantánea del servicio de cobertura, no un stock reservado para su cuenta. Confirme los números reales, las cotizaciones aplicables y cualquier requisito de registro antes de pedir. Un recuento correcto nunca autoriza una compra.

Distinguir un stock cero de una búsqueda fallida

Un recuento correcto de cero difiere de un error de la API. Inspeccione status.code y status.msg así como el estado HTTP. Trate un tiempo de espera o una búsqueda fallida como disponibilidad desconocida y reintente más tarde dejando un intervalo de espera entre intentos (backoff).

Solicitud

Utilice las credenciales de su cuenta de API habilitada a través de HTTPS. La autenticación Basic y los tokens bearer de cuenta de API habilitada son compatibles; se aplican restricciones de cuenta.

GET con el identificador de prefijo en la ruta URL. No hay parámetros de consulta ni de cuerpo documentados.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

Respuesta

Compruebe status.code en el cuerpo JSON así como el estado HTTP. Una response correcta tiene status.code 200 y status.msg Results. response es un objeto, no una lista: count es una instantánea de inventario en forma de entero; npa y nxx son cadenas de tres caracteres. status.results no está presente para este objeto asociativo. Un recuento de 0 significa que la búsqueda de cobertura no encontró ninguna central coincidente o devolvió un stock cero; no prueba que todos los proveedores u otras rutas de descubrimiento carezcan de números.

Forma de respuesta ilustrativa; no son datos reales de la cuenta ni una cotización actual.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

Errores

• 404: Proveedor deshabilitado: la cobertura de inventario móvil no está disponible en el servicio.
• 404: Identificador de prefijo no válido: obtenga un identificador de prefijo individual actual del descubrimiento.
• 404: Prefijo no válido: el prefijo almacenado no contiene suficientes dígitos para una búsqueda NPA/NXX.
• 500: Fallo de la cobertura de inventario: la búsqueda ascendente no devolvió un resultado de cobertura correcto. Reintente más tarde dejando un intervalo de espera entre intentos (backoff); un fallo no es un recuento de stock de cero.

Disponibilidad y efectos secundarios

• La operación comprueba el inventario y no realiza un pedido, no reserva números ni debita un importe de compra.
• El stock puede cambiar de inmediato. El recuento de cobertura no se ajusta para prometer una posibilidad de compra específica de la cuenta ni la misma longitud que la respuesta de la siguiente búsqueda de números.
• Una búsqueda contacta con el servicio de cobertura y puede tardar. No sondee repetidamente cada prefijo ni trate un tiempo de espera o un error como un stock cero correcto.