Guide d’intégration JavaScript

Ce guide vous accompagne dans l’intégration du SDK JavaScript Mon SMS PRO dans vos applications. Notre SDK est compatible avec Node.js, Next.js et la plupart des frameworks JavaScript modernes.

Installation

Pour commencer, installez le package via npm :


npm i @freddydrodev/monsmspro


pnpm add @freddydrodev/monsmspro


yarn add @freddydrodev/monsmspro


bun add @freddydrodev/monsmspro

Vous pouvez également utiliser yarn (yarn add @freddydrodev/monsmspro) ou pnpm (pnpm add @freddydrodev/monsmspro) selon votre préférence.

Configuration de la sécurité

Pour une meilleure sécurité, nous recommandons d’utiliser le package dotenv pour gérer vos variables d’environnement. Cette approche est particulièrement importante pour protéger votre clé API.

De nombreux frameworks modernes comme Next.js intègrent déjà dotenv. Vérifiez la documentation de votre framework pour plus de détails.

Configuration des variables d’environnement

Créez un fichier .env à la racine de votre projet :


touch .env

Ajoutez votre clé API au fichier .env :

.env


API_KEY="your_api_key"

⚠️

N’oubliez pas d’ajouter .env à votre .gitignore pour éviter de committer accidentellement votre clé API.

Initialisation du SDK

Créez une instance du SDK dans un fichier dédié pour une meilleure organisation de votre code :

./libs/sms.ts


import { MonSMSPRO } from "@freddydrodev/monsmspro";
 
export const sms = MonSMSPRO(process.env["API_KEY"] ?? "");

Bonnes pratiques

Sécurité : Utilisez toujours des variables d’environnement pour la clé API
Organisation : Centralisez l’instance du SDK dans un fichier dédié
TypeScript : Le SDK est entièrement typé pour une meilleure expérience de développement
Réutilisation : Importez l’instance sms là où vous en avez besoin

Exemple d’utilisation


import { sms } from "./libs/sms";
 
// Envoi d'un SMS
async function sendSMS() {
  try {
    const response = await sms.send({
      to: "+22500000000",
      message: "Votre message ici",
    });
    console.log("SMS envoyé avec succès:", response);
  } catch (error) {
    console.error("Erreur lors de l'envoi:", error);
  }
}

Support des frameworks

Notre SDK est compatible avec :

Node.js : Applications backend et scripts
Next.js : Applications full-stack
React : Applications frontend (côté serveur uniquement)
Express : Applications API
NestJS : Applications enterprise
TypeScript : Support natif des types