sms-altiria-client
Advanced tools
Altiria SMS NodeJs es un cliente que simplifica al máximo la integración de nuestro API para NodeJs. Por el momento, esta librería abarca las funciones más básicas:
Mediante el gestor de dependencias npm ejecutando el siguiente comando:
npm install sms-altiria-client --save
A continuación se describen cada una de las posibilidades de uso de la librería para realizar envíos de SMS.
Se muestra el código indispensable para realizar un envío básico. No se gestionan las excepciones.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña');
let textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
(async () => {
const data = await altiriaClient.sendSms(textMessage);
console.log('Mensaje enviado: ',await data);
})();
Se trata de la opción más sencilla para realizar un envío de SMS.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
async function sendSms() {
try {
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña');
let textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
let data = await altiriaClient.sendSms(textMessage);
console.log('¡Mensaje enviado!');
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Mensaje no aceptado: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
sendSms();
Permite fijar el tiempo de respuesta en milisegundos. Si se supera se lanzará una ConnectionException. Por defecto el tiempo de respuesta es de 10 segundos, pero puede ser ajustado entre 1 y 30 segundos.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
async function sendSms() {
try {
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña', false, 5000);
let textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
let data = await altiriaClient.sendSms(textMessage);
console.log('¡Mensaje enviado!');
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Mensaje no aceptado: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
sendSms();
Se trata de la opción más sencilla para realizar un envío de SMS añadiendo remitente. En este caso, se ilustra cómo realizar la autentificación mediante APIKEY, donde "XXXXXXXXXX" es el parámetro apiKey y "YYYYYYYYYY" el parámetro apiSecret.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
async function sendSms() {
try {
let altiriaClient = new AltiriaClient('XXXXXXXXXX', 'YYYYYYYYYY', true);
let textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba', 'miRemitente');
let data = await altiriaClient.sendSms(textMessage);
console.log('¡Mensaje enviado!');
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Mensaje no aceptado: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
sendSms();
Se muestra un ejemplo utilizando todo los parámetros e integrando el módulo winston para habilitar el loggin de la librería.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
const winston = require('winston');
async function sendSms() {
// Logger configuration
const logConfiguration = {
transports: [
new winston.transports.File({
filename: 'altiria-client.log',
level: 'debug'
})
],
exitOnError: false,
format: winston.format.combine(
winston.format.timestamp({
format: 'DD-MMM-YYYY HH:mm:ss'
}),
winston.format.printf(info => `${[info.timestamp]} ${info.level} - ${info.message}`)
)
};
const logger = winston.createLogger(logConfiguration);
try {
logger.info('Enviando SMS...');
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña');
altiriaClient.setTimeout=5000;
let textMessage = new AltiriaModelTextMessage('346XXXXXXXX', 'Mensaje de prueba');
textMessage.setSenderId='miRemitente';
textMessage.setAck=true;
textMessage.setIdAck='idAck';
textMessage.setConcat=true;
textMessage.setEncoding='unicode';
textMessage.setCertDelivery=true;
let data = await altiriaClient.sendSms(textMessage);
console.log('¡Mensaje enviado!');
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Mensaje no aceptado: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
sendSms();
A continuación se describen cada una de las posibilidades de uso de la librería para consultar el crédito.
Este ejemplo no incluye los parámetros opcionales.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
async function getCredit() {
try {
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña');
let credit = await altiriaClient.getCredit();
console.log('Credito: ',credit);
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Solicitud no aceptada: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
getCredit();
Este ejemplo permite definir el timeout.
const AltiriaClient = require('sms-altiria-client/src/altiria-client');
const AltiriaModelTextMessage = require('sms-altiria-client/src/altiria-model-text-message');
const AltiriaGwException = require('sms-altiria-client/src/exception/altiria-gw-exception.js');
const JsonException = require('sms-altiria-client/src/exception/json-exception.js');
const ConnectionException = require('sms-altiria-client/src/exception/connection-exception.js');
async function getCredit() {
try {
let altiriaClient = new AltiriaClient('miusuario@email.com', 'contraseña', false, 5000);
let credit = await altiriaClient.getCredit();
console.log('Credito: ',credit);
} catch (error) {
if(error instanceof AltiriaGwException) {
console.log('Solicitud no aceptada: '+error.getMessage);
console.log('Codigo de error: '+error.getStatus);
} else if(error instanceof JsonException) {
console.log('Error en la petición: '+error.getMessage);
} else if(error instanceof ConnectionException) {
console.log('Tiempo de espera agotado: '+error.getMessage);
}
}
}
getCredit();
La licencia de esta librería es de tipo MIT. Para más información consultar el fichero de licencia.
Utilizamos la sección de problemas de GitHub para tratar errores y valorar nuevas funciones. Para cualquier problema durante la intergración contactar a través del email soporte@altiria.com.
FAQs
Client library to send SMS using Altiria Gateway
The npm package sms-altiria-client receives a total of 98 weekly downloads. As such, sms-altiria-client popularity was classified as not popular.
We found that sms-altiria-client demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.