7. Package Report
El servicio cuenta con un reporte de consulta de estado de paquetes; este tiene el mismo esquema de autenticación.
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 para consumir el servicio:
https://apitellit.aldeamo.com/SmsiWS/packageReportPost
- Content-Type: application/json
- JSON petición:
{
"land": "",
"packageStateList": [
""
],
"packageTypeList": [
""
]
}
Parameters:
land: Indicativo del país a buscar. (Obligatorio)
packageStateList: Lista de estados a filtrar; puede tener uno de los siguientes valores. (Opcional)
Tabla 11 Tipo de paquetes disponibles
Estado | Descripción |
---|---|
SMS | Paquete de mensajes corrientes. |
FLASH | Paquete de mensajería tipo flash. |
DOC | Paquete de mensajería con archivos adjuntos |
packageTypeList: Lista de filtros por tipo de paquete; puede usarse uno de los siguientes estados. (Opcional)
Tabla 12 Estado de paquetes
Estado | Descripción |
---|---|
ENABLED | Paquete en estado normal y listo para ser consumido. |
DISABLED | Paquete deshabilitado manualmente. |
EXPIRED | Paquete con fecha de expiración posterior a la actual. |
FINISHED | Paquete consumido en su totalidad. |
Respuesta del servicio
{
"status": 1,
"reason": "Request Received",
"result": [
{
"totalSpent": 5236,
"total": 100000,
"available": 94764,
"state": "ENABLED",
"packageType": "SMS"
},
{
"totalSpent": 504,
"total": 10000,
"available": 9496,
"state": "ENABLED",
"packageType": "FLASH"
},
{
"totalSpent": 0,
"total": 10000,
"available": 10000,
"state": "ENABLED",
"packageType": "DOC"
}
]
}
Código de Respuesta – Status:
Tabla 13 Parámetros Respuesta HTTP POST
Código | Descripción | Nivel |
---|---|---|
1 | Petición recibida con éxito | General/Detallado |
-1 | Error de autenticación | General |
-2 | Ruta no configurada | Detallado |
-3 | Número celular inválido | Detallado |
-4 | Crédito insuficiente | General |
-5 | Error interno de la transacción | General/Detallado |
-6 | URL a acortar inválida | Detallado |
-7 | Fecha de envío inválida | General |
-8 | Petición con formato inválido | General |
-9 | Usuario bloqueado por intentos fallidos | General |
-10 | Código de país inválido | General |
-11 | Mensaje del cuerpo inválido | General |
-12 | ID de transacción Inválida | Detallado |