Inalambria API REST SMS

Este API permite, a las aplicaciones autenticadas mediante Bearer Token, enviar mensajes de texto a través de los canales SMS y RCS de manera eficiente y segura. Este documento detalla los requisitos técnicos, las especificaciones de los endpoints, los ejemplos de uso, las mejores prácticas y los escenarios comunes para facilitar la implementación y el uso del servicio.

Requisitos Previos

Acceso a una cuenta válida. Previamente se debe solicitar la configuración de una cuenta de envío.
Credenciales de autenticación para obtener el Bearer Token (usuario y contraseña proporcionados por Inalambria).

Requisitos de Sistema

Conexión a internet para interactuar con el API. Nuestra API se encuentra en el dominio: https://rest.inalambria.com.
Herramienta para realizar peticiones HTTP, como:
- Postman
- cURL
- Una librería HTTP en el lenguaje de programación de preferencia, por ejemplo:
  - HttpClient en C#
  - axios en JavaScript

Requisitos de Seguridad

Bearer Token válido para autenticar todas las solicitudes.
Habilitación de HTTPS para garantizar la seguridad de las comunicaciones.
Manejo adecuado del Bearer Token en el cliente para evitar filtraciones. Al solicitar el token:
- El cliente recibe el tiempo de expiración.
- Una vez expire el token, se cuenta con un servicio bajo solicitud para refrescar el token.

Formato y Validación de Datos

Los números de teléfono deben ser de 12 dígitos para Colombia, y para el resto del mundo deben estar en formato E.164.
Los mensajes de texto no tienen límite de caracteres, pero se aconseja que no superen los 500 caracteres.
Los payloads deben estar en formato JSON válido.

En caso de necesitar información adicional o aclaración en los requisitos por favor comuníquese con su ejecutivo de cuenta o mediante un correo electrónico a [email protected].

Autenticación

Nuestro servicio soporta dos métodos de autenticación:

Basic Authentication: En la cabecera se debe especificar el usuario y contraseña codificados en Base64.
Bearer Token: En la cabecera se debe enviar este token, y corresponde al método de autenticación recomendado.