Free Mobile SMS API : un canal de notif gratuit

Quand on construit un projet perso avec besoin de notification mobile (capteur qui déclenche, alerte serveur down, événement IoT…), les chemins habituels sont :

• Push Pushbullet / Pushover (gratuit limité, dépendance compte tiers)
• Twilio SMS (~0.07 €/SMS)
• ntfy.sh (excellent mais app dédiée)
• E-mail (peu bloquant en notification urgente)

Free Mobile propose un canal méconnu : une API HTTP simple pour s’envoyer un SMS à soi-même, gratuite, illimitée dans la pratique (~60 SMS/jour observés).

Setup en 30 secondes

1. Espace abonné Free Mobile → Mes Options → Notifications par SMS → activer
2. Free génère une clé alphanumérique (~14 caractères). À conserver — pas de régénération auto, mais révocable
3. Note ton identifiant Free (8 chiffres, début de ton numéro de compte)

C’est tout. Pas de validation par mail, pas de quota à débloquer, pas de carte bancaire.

Usage : un GET et c’est plié

curl -G "https://smsapi.free-mobile.fr/sendmsg" \
  --data-urlencode "user=12345678" \
  --data-urlencode "pass=AbCdEfGhIjKlMn" \
  --data-urlencode "msg=Alerte : pompe coupée à $(date +%H:%M)"

Codes retour :

• 200 : SMS envoyé
• 400 : paramètres manquants
• 402 : notifications SMS pas activées dans l’espace abonné
• 403 : rate limit dépassé OU clé révoquée
• 500 : erreur serveur (rare)

Le SMS arrive en quelques secondes sur TON propre numéro Free.

Limites à connaître

• SMS à toi-même uniquement : impossible de notifier un tiers (ce qui est sain — pas de spam transformable depuis ta clé)
• ~60 SMS/jour observés (non documenté officiellement). 403 si tu dépasses, reset à minuit
• One-way uniquement : pas de retour de lecture, pas de bidirectionnel
• Numéro Free obligatoire côté destinataire (forfait, prepaid, voire forfait à 0 €)
• HTTPS direct : pas besoin de proxy, marche partout (cloud, NAT, derrière box)

Patterns d’usage

• Backend home-assist : porte ouverte, capteur batterie faible
• Tracker GPS : chien sorti de zone, vélo qui bouge sans toi
• Server monitoring : down, certs qui expirent, espace disque critique
• CI/CD : deploy en prod échoué (filtré par sévérité)
• Domotique : événements rares dignes de notif immédiate

L’astuce : cooldown côté appli (ex. 60s entre 2 SMS du même type) pour ne pas griller le quota sur un bug en boucle.

Lessons learned

• Free Mobile expose une API SMS gratuite depuis ton espace abonné, activable en 30s — mais peu documentée donc sous-utilisée
• GET avec 3 params (user, pass, msg) — la simplicité parfaite, invocable depuis n’importe quel langage en 3 lignes
• Le numéro destinataire est figé à toi : sécurité native, la clé n’est pas détournable en spam
• ~60 SMS/jour : pas écrit dans la doc officielle, observé en pratique → cooldown applicatif obligatoire pour éviter le ban en boucle
• 403 ambigu : c’est soit rate limit, soit clé révoquée. Logger le moment de l’erreur permet de discriminer (rate limit = >60 dans la journée, sinon = clé)
• Pas de bidirectionnel : canal push uniquement. Pour les commandes inverses (phone → app), utiliser un autre canal (webhook + tunnel, Telegram bot…)

#sms #notification #free-mobile #iot #devops #monitoring #domotique