02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)

Envoyer un SMS en Node.js (API 123-SMS)

Mis à jour le 17 juillet 2026

Depuis Node.js 18, fetch est natif : l'envoi d'un SMS tient en une fonction async, sans aucune dépendance npm. Voici l'exemple complet pour vos backends, APIs et tâches automatisées.

1Le script complet (Node.js 18+, fetch natif)

// =====================================================================
//  Envoi de SMS via l'API 123-SMS.net  (Node.js 18+, fetch natif)
//  Documentation : https://www.123-sms.net/developpeurs-api.php
//  (c) 123-SMS.net - licence MIT, reutilisation libre
// =====================================================================

const API_URL = "https://www.123-sms.net/http.php";

// --- Vos identifiants (espace client 123-SMS.net) --------------------
const EMAIL   = "votre-email@exemple.fr";  // e-mail du compte
const CLE_API = "XXXXXX";                  // cle API : espace client > API

async function envoyerSMS(numero, message) {
  const params = new URLSearchParams({
    email: EMAIL,
    pass: CLE_API,
    numero: numero,
    message: message,
  });
  const reponse = await fetch(API_URL + "?" + params.toString());
  return (await reponse.text()).trim();
}

// --- Exemple ---------------------------------------------------------
envoyerSMS("0612345678", "Test 123-SMS depuis Node.js !")
  .then(code => console.log("Reponse de l'API :", code))
  .catch(err => console.error("Erreur :", err));

2Installation et utilisation

  • Téléchargez l'archive ou copiez le code dans envoyer-sms.js.
  • Renseignez EMAIL et CLE_API (espace client › API).
  • Lancez node envoyer-sms.js — la fonction envoyerSMS(numero, message) s'intègre dans tout projet.
  • En production : chargez la clé via process.env plutôt qu'en dur.
La clé API se génère dans l'espace client, rubrique API › Générer Clé API. Les codes réponse et le retour des accusés de réception par HTTP sont détaillés dans la documentation technique.

Questions fréquentes

Quelle version de Node.js est requise ?

Node.js 18 ou supérieur (fetch natif). Sur une version antérieure, le même appel fonctionne avec axios ou node-fetch.

Peut-on utiliser ce code côté navigateur ?

Non : votre clé API serait exposée dans le code public. L'envoi doit toujours partir de votre serveur ; le navigateur appelle votre backend, qui appelle 123-SMS.

Et en TypeScript ?

Le même code s'utilise tel quel ; typez simplement la fonction : envoyerSMS(numero: string, message: string): Promise<string>.

Comment suivre la délivrance ?

Code réponse immédiat de l'API, accusés de réception retournés par HTTP à votre serveur (documentation dédiée), et suivi dans l'espace client.

Téléchargement

123-sms_nodejs.zip

Licence MIT — libre et gratuit.

L'essentiel

  • API HTTPS en un appel GET : email, clé API, numéro, message.
  • Code réponse immédiat + accusés de réception par HTTP.
  • Crédits prépayés sans abonnement ni expiration.
  • Adaptations spécifiques développées gratuitement.