3.1. MT: Web Service Rest tipo GET
Este API está basado en llamados HTTP GET ideales para transacciones básicas y rápidas hechas por el cliente a una URL. Bajo este esquema los parámetros de la solicitud de envío se adjuntan a la petición HTTP vía GET.
Autenticación
El usuario se autentica por medio de usuario y contraseña codificados (en base 64) en el encabezado “Authorization” bajo el estándar “basic” de la siguiente forma:
Authorization = Basic Base64({usuario}:{contraseña})URL de la petición:
https://apitellit.aldeamo.com/SmsiWS/smsSendGet?mobile={NumeroCelular} &country={CódigoPaís}&message={Mensaje}&messageFormat={Formato}Parámetros:
Tabla 1 Parámetros HTTP GET
Esquema de la respuesta
{
"status": 1,
"reason": "Request Received",
"result": {
"totalRequest": 1,
"totalFailed": 0,
"receivedRequests": [
{
"mobile": "3118644939",
"transactionId": "postT02615L57G3118644939Rm4yx8Psmsi",
"status": 1,
"reason": "Request Received"
}
],
"failedRequests": [],
"dateToSend": "2018-01-26 14:42:00",
"timeZone": "America/Bogota"
}
}
Descripción de la respuesta:
• status: Código del resultado de la solicitud (número)
• reason: Resultado de la solicitud (texto)
• result: Detalle del resultado de la solicitud
– totalRequest: Total de destinatarios recibidos en la solicitud
– totalFailed: Total de destinatarios recibidos que NO se enviarán
– ReceivedRequests: Lista detallada de destinatarios a los que se les enviará el mensaje
▪ mobile: Número celular (GSM)
▪ transactionId: Código de transacción del mensaje
▪ status: Código de la razón de la falla
▪ reason: Estado de la transacción/Razón de la falla
– failedRequests: Lista de detalles de los destinatarios que NO se enviarán
▪ mobile: Número celular (GSM)
▪ transactionId: Código de transacción del mensaje único por mensaje.
Ej. getT02917L57G3118644939RdrvaxPsmsi
▪ status: Código de la razón de la falla
▪ reason: Estado de la transacción/Razón de la falla
– dateToSend: Fecha y hora a la que saldrá el envío
– timeZone: Zona horaria de la fecha a la que saldrá el envío