Documentación de la API REST

APIs REST de llamadas de emergencia

Registre un número y la dirección del servicio, siga su estado de activación y mantenga el registro actualizado a medida que cambie la ubicación.

Abrir la referencia específica de la cuenta Desarrolladores y Automatización

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 la cobertura sin registrar un número

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multi.tel/emergency/coverage?environment=production"

También se admite https://api.multitel.net/emergency. Ninguna URL base de emergencias contiene /v3. La cobertura enumera los países cubiertos por el servicio internacional, los tipos de número admitidos y los precios; la admisibilidad de E911 en Norteamérica se comprueba durante el registro.

{
  "code": 200,
  "message": "",
  "environment": "production",
  "requestId": "EXAMPLE_REQUEST_ID",
  "data": {}
}

Esto solo ilustra la envoltura. Consulte el esquema data de cada operación en la guía publicada de la API de emergencias.

Registre, siga el estado y configure después las llamadas

Para EE. UU./Canadá y las demás regiones compatibles de E911 en Norteamérica, indique el número, la dirección de E911 y las confirmaciones de consentimiento requeridas. E911 en Norteamérica solo está disponible en producción.
Para un número internacional compatible propiedad de la cuenta, proporcione una referencia de documento guardado o la identidad y la dirección del usuario final. Revise antes los requisitos del país y del tipo de número.
Envíe una solicitud POST /registrations. Una Idempotency-Key opcional identifica una mutación lógica; consérvela y conserve el payload exacto en los reintentos.
Consulte GET /registrations/:number. Revise el ciclo de vida, pending y actionRequired; corrija lo que sea necesario. La aceptación o el estado pendiente no constituyen servicio activo.
Tras la activación, configure el identificador de llamante de emergencia correcto y la ruta de marcación específica del país. Utilice el procedimiento de verificación del servicio que no implique llamadas de emergencia.

Los registros internacionales en el entorno de pruebas están aislados y no activan llamadas de emergencia reales. Se requieren las credenciales de la cuenta principal para E911 en Norteamérica; la guía explica la compatibilidad limitada con subcuentas internacionales.

Configuración y verificación en el portal Cobertura por país y números de emergencia Guía completa de solicitudes públicas, campos, estados y reintentos

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.

Catálogo de puntos finales específicos de la cuenta Consola REST de comunicaciones Documento OpenAPI público de comunicaciones Guía de integración OAuth