Le moyen le plus simple et le plus recommandé (lire: le plus intelligent) d’utiliser l’API REST de nomado dans votre application nodejs consiste à utiliser notre sdk.
npm install nomado
Si vous n’avez pas encore de compte nomado, créez-en un ici et recevez jusqu’à 10€ de crédit pour continuer et tester.
Voici un exemple rapide pour initialiser la librairie et envoyer un SMS.
const nomadoClient = require('nomado');
const USERNAME = 'username';
const PASSWORD = 'password';
const nomado = new nomadoClient({USERNAME, PASSWORD});
const smsOptions = {
to: ['32456789012'],
message: 'Hello world',
unicode: false
};
nomado.sms.send(smsOptions)
.then((response) => {
console.log(response.code);
console.log(response.data);
})
.catch((error) => {
console.log(error.code);
console.log(error.reason);
});
Chaque appel renverra une promesse qui sera résolue (ou rejetée) avec un objet nomadoResponse encapsulant le code de réponse de l’API et les données.
// Result object:
{
code: 200, //OK!
reason: "", //in case of error
data: {}
}
Commencez par initialiser la librairie avec vos identifiants nomado.
const nomado = new nomadoClient({USERNAME, PASSWORD});
Vous pouvez maintenant commencer à envoyer des demandes à l’API.
La classe nomadoClient fournit les interfaces publiques pour accéder à l’API nomado
SMSOTPHLRCallsAccountEnvoyer un SMS vers un ou plusieurs numéros.
nomado.sms.send({
to: ['3245678901','3245678902'], // e164 formatted numberr in array
message: 'My first sms from nomado!',
unicode: false // Boolean: unicode.
});
Générer un code OTP (code PIN à usiage unique) et envoyer des SMS à vos utilisateurs est aussi simple que ci-dessous:
nomado.otp.send({
"to": "32412345678",
"template": "Your verification code is {{CODE}}",
"type": "NUMERIC",
"length": 4,
"expiry": 7200
})
nomado.otp.verify({
number: '32456789012', // E164 formatted mobile number used,
token: '456789' // OTP generated in previous call. You do not need to store it locally.
})
Effectuer une requête
nomado.hlr.fetch({
numbers: ['32456789012','32456789013'], // e164 formatted numbers
});
nomado.hlr.validate({
number: '32456789012', // e164 formatted number
});