API HTTP
La API HTTP externa de SMS te permite integrar el envío de mensajes SMS a tu sistema utilizando un flujo de autenticación estándar OAuth2 (client_credentials) contra Keycloak, seguido de una llamada REST al endpoint de mensajería.
Tu sistema siempre realiza dos operaciones: primero obtiene un token temporal con tu llave de API, luego lo usa para enviar el SMS. El token tiene una vigencia de aproximadamente 10 minutos, por lo que puedes reutilizarlo para múltiples envíos.
Flujo general
| Paso | Origen | Destino | Acción |
|---|---|---|---|
| 1 | Tu sistema | Keycloak | POST /token (client_id + client_secret) |
| 2 | Keycloak | Tu sistema | Devuelve access_token (válido ~10 min) |
| 3 | Tu sistema | API de mensajería | POST /services/messaging (Bearer access_token) |
| 4 | API de mensajería | Tu sistema | Devuelve code, mailingId, result |
Cachea el token en memoria y solicita uno nuevo cuando esté por vencer. No lo solicites de nuevo en cada envío — ralentiza tu integración innecesariamente.
Antes de empezar necesitas una llave de API (Client ID + Secret). Si aún no la tienes, pídesela al administrador de tu cuenta para que la genere desde el portal.