Confirme que el inventario móvil está habilitado
Utilice esta búsqueda solo después de que el inventario de números móviles haya sido habilitado para su cuenta de cliente. Obtenga un prefijo móvil individual actual mediante el flujo de descubrimiento de la cuenta. La ruta admitida solicita inventario inalámbrico para ese prefijo. No depende de un registro de metadatos de enrutamiento de línea fija coincidente. Contacte con soporte si no está seguro de si su cuenta o prefijo está habilitado.
La ruta heredada actual no rechaza de forma fiable cada solicitud no elegible. Una cuenta sin inventario móvil habilitado puede recibir inventario ordinario mientras la respuesta sigue diciendo info.is_mobile: 1. Un prefijo gratuito también puede alcanzar la rama de inventario gratuito con esa etiqueta. No utilice esa etiqueta por sí sola para identificar el servicio móvil, y no envíe prefijos ordinarios o gratuitos a este punto de conexión. Utilice el catálogo móvil confirmado de la cuenta y el flujo habilitado.
Mantenga cada número con su propia selección de precio
Para cada candidato, mantenga juntos number, info.uuid y la lista price de esa misma entrada. La respuesta también contiene metadatos de prefijo/área/país, términos contractuales y restricciones de registro. Los candidatos se ordenan por el precio mensual de su primera opción de precio, de forma ascendente; no hay un orden estable garantizado para precios iguales. No sustituya el identificador del número devuelto por un identificador de área o prefijo, ni lo empareje con el identificador de precio de otro candidato.
La respuesta completa puede incluir campos adicionales de metadatos y de precio. Los features devueltos, los valores de canales y las restrictions describen el candidato; no son una garantía de que las llamadas, los SMS, los MMS o el fax ya sean utilizables. Los permisos de la cuenta, el registro y el plan de servicio seleccionado siguen aplicándose. No trate los marcadores de posición del ejemplo como identificadores o precios válidos.
Utilice una cantidad pequeña y positiva
Comience con una cantidad de 1. La solicitud normal al proveedor normaliza una cantidad no positiva a 1 y limita el valor ascendente a 300, pero el manejo posterior de los resultados sigue utilizando la entrada original. Una cantidad cero puede, por lo tanto, solicitar inventario ascendente y no devolver ningún candidato. Otras ramas heredadas no aplican de forma coherente el recuento de resultados solicitado. No confíe en un único máximo universal ni envíe valores negativos, fraccionarios o no numéricos. No se documenta ningún filtro de búsqueda público admitido ni parámetro de cuerpo de identificador de precio para esta ruta.
Distinga la falta de stock de un fallo de búsqueda
Una respuesta 404 puede representar inventario no disponible, servicio deshabilitado, un fallo de búsqueda del proveedor o registros de catálogo no válidos. Trate un tiempo de espera o un fallo del proveedor como disponibilidad desconocida en lugar de stock cero confirmado. Actualice la selección y reintente dejando un intervalo de espera entre intentos (backoff) cuando sea apropiado. Evite sondear cada central repetidamente. El punto de conexión separado de recuento de inventario móvil es una indicación de instantánea y no necesita coincidir con la longitud de la lista de candidatos de esta cuenta.
Verifique de nuevo antes de comprar
La búsqueda no reserva stock. La rama revisada intenta excluir los números ya comprados, pero un fallo en la búsqueda de reservas locales puede dejar tal candidato en el resultado. La disponibilidad, la titularidad, los precios aprobados y el registro deben ser verificados por el flujo de compra. Utilice una selección nueva con la solicitud de compra protegida, y concilie el inventario de la cuenta después de cualquier resultado de compra incierto antes de reintentar. Nunca compre meramente porque se devolvió un candidato.
Solicitud
Utilice una cuenta API habilitada a través de HTTPS desde una dirección IP de origen permitida. El inventario móvil también debe estar habilitado para la cuenta de cliente; la autenticación API por sí sola no lo habilita.
GET con el identificador de prefijo individual actual y una cantidad entera positiva en la ruta del URL. La cantidad es 1 por defecto si se omite. Utilice el ejemplo con 1; esta ruta no valida ni aplica de forma coherente un límite de resultados universal.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
prefix_id | string | Sí | El identificador visible opaco de un prefijo móvil individual elegible obtenido del descubrimiento. Utilice un prefijo de central móvil NPA/NXX admitido por su cuenta; no lo sustituya por un identificador de área, un identificador de visualización agrupado, un prefijo de marcación literal ni un prefijo gratuito. |
quantity | integer | No | Número de candidatos solicitado. 1 por defecto. Proporcione un número entero positivo moderado. La solicitud normal ascendente limita su cantidad a 300, pero eso no es una entrada universalmente validada ni una garantía de tamaño de respuesta. |
Respuesta
Inspeccione status.code y status.msg en el cuerpo JSON así como el estado HTTP. En caso de éxito, response es una lista de candidatos de números, status.msg es Results: seguido del número devuelto, y status.results es la longitud de la lista serializada. Los precios de los candidatos son específicos de la cuenta. El ejemplo abreviado ilustrativo utiliza marcadores de posición en lugar de inventario real o una cotización tarifaria. Los números contienen el código del país sin signo más; los identificadores son cadenas opacas.
Forma de respuesta ilustrativa; no son datos reales de la cuenta ni una cotización actual.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Errores
- 404: identificador de prefijo, país o área no válido: actualice la selección del prefijo móvil individual.
- 404: no se encontraron números: puede significar que no hay stock utilizable, servicio deshabilitado, fallo de búsqueda del proveedor, selección no admitida o limitaciones de la cuenta. No es prueba de un recuento de inventario cero autoritativo.
Disponibilidad y efectos secundarios
- La búsqueda no alquila ni reserva un número y la ruta revisada no debita un importe de compra. Contacta con el proveedor de inventario y puede tardar.
- Las búsquedas exitosas escriben entradas de caché de números y precios relacionadas con la cuenta así como registros de consultas. Repetir una búsqueda no es una reserva, ni un bloqueo de precio, ni una compra.
- Los precios, términos, restricciones y capacidades devueltos deben ser revisados para la cuenta y el número seleccionados. Una etiqueta de función no establece la activación, la aprobación de mensajería ni una funcionalidad de servicio probada.