Documentación de la API REST
API REST de búsqueda de enrutamiento LRN
Consulte el número de encaminamiento y la información del operador disponible para un número telefónico norteamericano a un precio fijo por consulta.
Elija juntos la API y la credencial
Las cuentas aprobadas de Desarrolladores y Automatización, Empresa y Proveedores de comunicaciones pueden integrar los servicios habilitados. Un desarrollador individual no necesita fingir que es una empresa. Los SMS/MMS de aplicación requieren la aprobación de envío y el registro aplicables. El servicio Particulares y familias no dispone de ninguna API accesible al cliente para iniciar el envío de mensajes.
| Familia de API | URL base | Autenticación y resultado |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Credenciales Basic aprobadas; tokens provisionados admisibles solo para las operaciones que los admitan. JSON con status y response. |
| Registro del servicio de llamadas de emergencia | https://api.multi.tel/emergency | Credenciales Basic aprobadas o acceso bearer provisionado específicamente. JSON con code, message y data. |
| Integraciones REST del portal | Host y operación indicados en la referencia para desarrolladores de su cuenta | Utilice la credencial, los ámbitos y el esquema documentados para esa operación. Las solicitudes de sesión del navegador utilizan una interfaz aparte. |
Configure MULTITEL_API_USERNAME y MULTITEL_API_PASSWORD mediante la configuración de secretos de su servidor antes de utilizar los ejemplos. No los incluya nunca en código JavaScript público del navegador, en URL ni en el control de versiones. Las credenciales dedicadas se gestionan en los ajustes de integración de API.
Consultar un número
GET /v3/lrn/{number} acepta el número de destino en la ruta. Se puede proporcionar un número de origen opcional como /v3/lrn/{number}/{ani} para la información dependiente del origen. Introduzca los números telefónicos norteamericanos solo con dígitos e incluya el código de país cuando proceda; los ejemplos utilizan números ficticios reservados.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"Ejecutar una consulta con credenciales válidas es facturable. La tarifa es de 0,00025 US$ por consulta: 0,25 US$ por cada 1000 o 250 US$ por millón. No hay descuentos por volumen. Esta es una consulta de información de encaminamiento; no realiza ninguna llamada telefónica.
Leer el resultado
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}Este ejemplo inventado solo muestra la forma de la respuesta; no es un resultado de encaminamiento medido. Compruebe status.code antes de utilizar response. El campo cost es una cadena con prefijo de moneda, no un número JSON.
| Campo | Significado |
|---|---|
lrn | Número de encaminamiento de ubicación (Location Routing Number) utilizado para identificar el destino del encaminamiento. |
ported | Indicador de que el número ha sido portado, proporcionado por esta consulta: normalmente 0 o 1. No lo utilice como prueba de propiedad ni de admisibilidad del servicio. |
ocn | Número de compañía operadora (Operating Company Number), cuando se proporcione. |
lata | Zona de acceso y transporte local (Local Access and Transport Area), cuando se proporcione. |
rc | Centro tarifario (rate center), cuando se proporcione. |
city, state, lec, lectype, jurisdiction, local | Detalles adicionales de ubicación, operador u origen, cuando estén disponibles. Pueden faltar o estar vacíos. |
No exija que estén presentes todos los campos de encaminamiento. En particular, los resultados de números gratuitos para quien llama pueden omitir los detalles locales del centro tarifario y del código de operador. Un LRN devuelto no constituye una garantía en tiempo real de alcanzabilidad ni una prueba de calidad de llamada.
Utilice las consultas en su flujo de encaminamiento
- Valide y normalice el número solicitado antes de enviarlo.
- Compruebe el estado HTTP y el estado de aplicación. Conserve un registro expurgado del número, la hora y el resultado para la resolución de problemas.
- Utilice solo los campos pertinentes para su regla de encaminamiento y gestione explícitamente los valores ausentes.
- Limite los reintentos tras una respuesta incierta. Repetir una consulta puede generar otro cargo; este punto final no tiene ninguna clave de idempotencia documentada.
Consulte el producto LRN y el precio uniforme por consulta. La ruta pública OpenAPI incluye un segmento ANI; la implementación LRN desplegada también acepta la solicitud más corta sin ANI. lrninfo es una operación distinta y no debe utilizarse como sustituto de este punto final.
Gestión de errores y reintentos
- Fallo de autenticación o de permiso
- Compruebe el estado habilitado de la credencial de API, el servicio permitido y la restricción de IP de origen. Una cookie de sesión del portal no es una credencial de integración.
- Crédito insuficiente o aprobación pendiente
- Resuelva el saldo de la cuenta, la aprobación de envío o el requisito de documentación antes de repetir la operación.
- Sin resultado
- Trate el inventario vacío o la falta de nombre del llamante como un resultado normal. No suponga que un número sintácticamente válido dispone de todos los servicios.
- Tiempo de espera de red o fallo del servicio
- Utilice reintentos limitados con espera progresiva para las lecturas. Para una compra, un envío o un registro, compruebe primero el estado de la operación; reintentar una solicitud aceptada puede duplicar una acción facturable.
La compatibilidad con la idempotencia pertenece a cada familia de API. La API de emergencias admite claves de reintento; esto no hace que las solicitudes arbitrarias de la v3 sean idempotentes. Conserve las marcas de tiempo, los identificadores devueltos y las respuestas expurgadas para el soporte.
Continúe con la referencia de su cuenta
La referencia disponible tras iniciar sesión filtra las operaciones según sus permisos y servicios habilitados. Utilice el host exacto, el tipo de credencial, los campos de solicitud y el esquema de respuesta indicados. Las consolas pueden ejecutar operaciones reales, incluidas compras y envíos de mensajes.