API Free Mobile : Envoyer des SMS Gratuits (Guide 2025)

Temps de lecture estimé : 10 minutes

Introduction

L’API Free Mobile SMS représente une solution gratuite et efficace pour envoyer des notifications par SMS depuis vos applications, scripts ou systèmes de monitoring. Que vous soyez développeur, administrateur système ou simple passionné de domotique, cette API vous permet de recevoir des alertes instantanées sur votre mobile sans aucun coût supplémentaire.

Concrètement, il s’agit d’un service proposé par Free aux abonnés mobiles qui souhaitent automatiser l’envoi de SMS vers leur propre numéro. Dans les faits, l’utilisation reste assez simple : une simple requête HTTP suffit pour déclencher l’envoi d’un message. Ce qui change vraiment la donne, c’est la gratuité totale du service et sa fiabilité pour des usages personnels.

Dans ce guide complet, je vous explique comment activer et utiliser l’API Free Mobile pour envoyer des SMS gratuitement, avec des exemples concrets dans différents langages de programmation. Vous découvrirez également les cas d’usage les plus pertinents et les limites à connaître avant de déployer votre solution.

Qu’est-ce que l’API Free Mobile SMS

L’API Free Mobile est un service de notification par SMS proposé gratuitement par l’opérateur Free à ses abonnés mobiles. Contrairement aux APIs SMS commerciales classiques destinées à l’envoi massif, cette API est spécifiquement conçue pour un usage personnel et limité.

Le principe est simple : Free vous attribue un identifiant unique et une clé API que vous intégrez dans vos applications. Lorsque votre code effectue une requête HTTP vers les serveurs de Free avec ces identifiants, un SMS est automatiquement envoyé vers votre numéro Free Mobile.

Conseil : L’API Free Mobile est idéale pour recevoir des alertes de vos serveurs, systèmes domotiques ou applications personnelles. En revanche, elle ne convient pas pour envoyer des SMS à d’autres numéros ou pour un usage commercial.

Les avantages principaux de cette solution sont multiples. Premièrement, elle est totalement gratuite pour tous les abonnés Free Mobile. Deuxièmement, l’intégration technique reste extrêmement simple et ne nécessite aucune bibliothèque complexe. Enfin, la fiabilité du service s’avère excellente pour des volumes raisonnables de notifications.

Activation et configuration de l’API

Prérequis obligatoires

Avant de pouvoir utiliser l’API Free Mobile SMS, vous devez remplir quelques conditions essentielles. Vous devez disposer d’un forfait mobile Free actif, qu’il s’agisse d’un forfait payant ou du Forfait Free à 2 euros. Les cartes prépayées et les lignes sans forfait ne donnent pas accès à ce service.

Soyons réalistes, cette limitation écarte une partie des utilisateurs, mais elle se justifie par la volonté de Free de réserver ce service aux abonnés réguliers. Vous devez également avoir accès à votre espace abonné Free Mobile en ligne, car c’est depuis cette interface que vous activerez l’option et récupérerez vos identifiants API.

Activer l’option notifications par SMS

L’activation de l’API Free Mobile se fait en quelques clics depuis votre espace abonné. Voici la procédure complète à suivre :

1. Connexion à l’espace abonné : Rendez-vous sur mobile.free.fr et connectez-vous avec votre identifiant Free Mobile et votre mot de passe.
2. Accès aux options : Dans le menu principal, cliquez sur « Gérer mon compte » puis sur « Mes options ».
3. Activation du service : Recherchez l’option « Notifications par SMS » et activez-la en cochant la case correspondante.
4. Récupération des identifiants : Une fois activée, l’interface affiche votre identifiant utilisateur et votre clé API. Notez précieusement ces deux informations.

Attention : Votre clé API est confidentielle et permet d’envoyer des SMS sur votre numéro. Ne la partagez jamais publiquement et ne la commitez pas dans vos dépôts Git publics.

Votre identifiant utilisateur correspond généralement à votre numéro de téléphone mobile Free, tandis que la clé API est une chaîne alphanumérique aléatoire d’une quinzaine de caractères. Ces deux éléments constituent vos credentials pour toutes vos futures requêtes API.

Utiliser l’API Free Mobile : exemples de code

L’utilisation de l’API Free Mobile repose sur une simple requête HTTP GET vers l’URL suivante :

https://smsapi.free-mobile.fr/sendmsg?user=VOTRE_USER&pass=VOTRE_CLE&msg=Votre_message

Les paramètres à transmettre sont au nombre de trois : user pour votre identifiant utilisateur, pass pour votre clé API, et msg pour le contenu du message à envoyer. Le message doit être encodé en URL pour gérer correctement les caractères spéciaux et les espaces.

Envoi simple avec cURL

La méthode la plus simple pour tester l’API consiste à utiliser cURL depuis votre terminal :

curl "https://smsapi.free-mobile.fr/sendmsg?user=12345678&pass=AbCdEfGhIjKlMnO&msg=Test%20API%20Free%20Mobile"

Remplacez 12345678 par votre identifiant utilisateur et AbCdEfGhIjKlMnO par votre clé API réelle. Le message « Test API Free Mobile » devrait arriver sur votre téléphone en quelques secondes si tout est correctement configuré.

Intégration Python

En Python, l’intégration se fait naturellement avec la bibliothèque requests ou même le module standard urllib. Voici un exemple simple et réutilisable :

import requests
from urllib.parse import quote

def envoyer_sms_free(message):
    user = "12345678"  # Votre identifiant
    api_key = "AbCdEfGhIjKlMnO"  # Votre clé API
    
    url = f"https://smsapi.free-mobile.fr/sendmsg"
    params = {
        'user': user,
        'pass': api_key,
        'msg': message
    }
    
    try:
        response = requests.get(url, params=params, timeout=10)
        if response.status_code == 200:
            print("SMS envoyé avec succès")
            return True
        else:
            print(f"Erreur : code {response.status_code}")
            return False
    except requests.exceptions.RequestException as e:
        print(f"Erreur réseau : {e}")
        return False

# Utilisation
envoyer_sms_free("Serveur démarré avec succès")

Cette fonction gère automatiquement l’encodage URL du message grâce au paramètre params de requests. Elle inclut également une gestion basique des erreurs réseau et des codes HTTP retournés par l’API.

Intégration PHP

Pour les développeurs PHP, voici une fonction simple utilisant file_get_contents :

<?php
function envoyerSmsFree($message) {
    $user = "12345678";
    $apiKey = "AbCdEfGhIjKlMnO";
    
    $url = "https://smsapi.free-mobile.fr/sendmsg?" . http_build_query([
        'user' => $user,
        'pass' => $apiKey,
        'msg' => $message
    ]);
    
    $context = stream_context_create([
        'http' => [
            'timeout' => 10,
            'ignore_errors' => true
        ]
    ]);
    
    $response = @file_get_contents($url, false, $context);
    
    if ($response !== false) {
        echo "SMS envoyé avec succès\n";
        return true;
    } else {
        echo "Erreur lors de l'envoi du SMS\n";
        return false;
    }
}

// Utilisation
envoyerSmsFree("Nouvelle commande reçue sur le site");
?>

Cette implémentation utilise http_build_query pour construire proprement l’URL avec les paramètres encodés. Le timeout de 10 secondes évite que votre script ne reste bloqué indéfiniment en cas de problème réseau.

Intégration Bash/Shell

Pour les administrateurs système qui travaillent principalement en ligne de commande, voici un script Bash réutilisable :

#!/bin/bash

USER="12345678"
API_KEY="AbCdEfGhIjKlMnO"
MESSAGE="$1"

if [ -z "$MESSAGE" ]; then
    echo "Usage: $0 \"Votre message\""
    exit 1
fi

# Encodage URL du message
ENCODED_MSG=$(echo -n "$MESSAGE" | jq -sRr @uri)

# Envoi du SMS
curl -s -o /dev/null -w "%{http_code}" \
    "https://smsapi.free-mobile.fr/sendmsg?user=$USER&pass=$API_KEY&msg=$ENCODED_MSG"

if [ $? -eq 0 ]; then
    echo "SMS envoyé"
else
    echo "Erreur lors de l'envoi"
fi

Enregistrez ce script sous le nom sms_free.sh, rendez-le exécutable avec chmod +x sms_free.sh, et utilisez-le simplement avec ./sms_free.sh "Votre message". Ce script exploite jq pour l’encodage URL, mais vous pouvez également utiliser python3 -c "import urllib.parse; print(urllib.parse.quote('...'))" si jq n’est pas disponible.

Cas d’usage pratiques

L’API Free Mobile SMS trouve de nombreuses applications concrètes dans le quotidien des développeurs et des administrateurs système. Voici les cas d’usage les plus pertinents que j’ai pu observer sur le terrain :

Monitoring serveur et infrastructure

Le monitoring représente probablement le cas d’usage le plus répandu de l’API Free Mobile. Vous pouvez configurer vos scripts de surveillance pour envoyer des alertes SMS lorsque certains seuils sont dépassés : utilisation CPU supérieure à 90%, espace disque critique, service arrêté, ou échec de sauvegarde.

Dans les faits, cette approche vous permet de réagir rapidement aux incidents, même lorsque vous n’êtes pas devant votre ordinateur. Un simple script cron qui vérifie l’état de vos services toutes les 5 minutes et envoie un SMS en cas de problème peut vous éviter des heures d’indisponibilité.

Domotique et IoT

Les projets domotiques basés sur Raspberry Pi, Arduino ou ESP32 peuvent exploiter cette API pour envoyer des notifications. Détection d’intrusion, alertes de température anormale dans une serre, notification de livraison via capteur de porte, ou alerte de fuite d’eau : les possibilités sont infinies.

Ce qui change vraiment la donne ici, c’est la simplicité d’intégration. Même un microcontrôleur basique peut effectuer une requête HTTP GET, ce qui rend l’API accessible à tous les projets IoT sans nécessiter de passerelle complexe.

Notifications d’applications web

Vos applications web personnelles peuvent utiliser l’API pour vous notifier d’événements importants : nouvelle inscription utilisateur, commande passée sur votre boutique, commentaire laissé sur votre blog, ou erreur critique détectée en production.

Concrètement, cette solution reste bien plus fiable que les notifications push navigateur qui peuvent être bloquées ou ignorées. Un SMS arrive toujours et capte immédiatement l’attention.

Rappels et automatisations personnelles

Au-delà des usages techniques, l’API peut servir pour des automatisations du quotidien : rappel de prendre un médicament via un script cron, notification de départ pour un rendez-vous basée sur les conditions de trafic, alerte météo personnalisée, ou même rappel d’anniversaire.

Limites et contraintes de l’API

Soyons réalistes : l’API Free Mobile SMS comporte des limitations importantes qu’il faut connaître avant de l’intégrer dans vos projets. Ces contraintes définissent le périmètre d’utilisation raisonnable du service.

Limitation du volume d’envois

Free n’indique pas publiquement de quota officiel, mais d’après les retours terrain, l’API supporte environ 200 à 250 SMS par jour maximum. Au-delà, vos requêtes risquent d’être rejetées temporairement. Cette limite reste largement suffisante pour du monitoring ou des notifications personnelles, mais elle écarte tout usage intensif.

Il existe également un rate limiting non documenté qui empêche l’envoi de plusieurs SMS rapprochés. Si vous envoyez trop de messages en quelques secondes, certains peuvent être perdus. Je recommande de respecter un délai d’au moins 10 secondes entre deux envois pour garantir la délivrabilité.

Envoi uniquement vers son propre numéro

L’API Free Mobile ne permet d’envoyer des SMS que vers le numéro Free Mobile associé au compte. Vous ne pouvez pas envoyer de messages vers d’autres numéros, qu’ils soient Free ou d’un autre opérateur. Cette restriction bloque tout usage commercial ou de masse.

Longueur des messages

Les messages sont limités à environ 160 caractères par SMS. Au-delà, le message sera tronqué sans concaténation automatique. Vous devez donc privilégier des messages concis et informatifs, en allant directement à l’essentiel.

Disponibilité du service

Bien que généralement fiable, l’API peut connaître des interruptions temporaires lors de maintenances Free ou de problèmes techniques. Pour des alertes critiques nécessitant une disponibilité absolue, je recommande d’implémenter un système de fallback vers une autre solution de notification.

Contrainte	Limitation	Impact
Volume quotidien	~200-250 SMS/jour	Acceptable pour monitoring personnel
Rate limiting	~10 secondes entre envois	Adapter la fréquence des alertes
Destinataires	Uniquement son numéro	Usage personnel exclusivement
Longueur	160 caractères max	Messages concis obligatoires
Disponibilité	Non garantie SLA	Prévoir solution de secours

Sécuriser vos envois SMS

La sécurisation de votre implémentation reste cruciale pour éviter tout usage frauduleux de votre clé API. Voici les bonnes pratiques essentielles que j’applique systématiquement sur mes projets.

Ne jamais exposer la clé API

Votre clé API doit rester strictement confidentielle. Ne la commitez jamais dans un dépôt Git public, même si vous pensez supprimer le commit plus tard. Une fois indexée par les moteurs de recherche ou les scrapers GitHub, votre clé devient publique définitivement.

Utilisez des variables d’environnement ou des fichiers de configuration exclus du versioning. En Python, exploitez python-dotenv avec un fichier .env listé dans votre .gitignore. En PHP, stockez les credentials dans un fichier de configuration hors de la racine web.

Limiter les accès côté serveur

Ne placez jamais le code d’envoi de SMS directement dans votre front-end JavaScript. Toute clé API présente dans le code client devient instantanément accessible à n’importe quel utilisateur via les outils de développement du navigateur. Créez plutôt un endpoint backend qui valide les demandes avant d’effectuer l’appel API.

Implémenter un rate limiting applicatif

Même si l’API Free possède son propre rate limiting, ajoutez une couche de contrôle dans votre application pour éviter les abus. Limitez par exemple l’envoi à 10 SMS par heure maximum pour un même type d’alerte, ou implémentez un système de cooldown entre deux notifications identiques.

Valider le contenu des messages

Si votre application permet à des utilisateurs d’influer sur le contenu des SMS envoyés, validez et sanitisez systématiquement les inputs pour éviter toute injection de contenu malveillant. Limitez la longueur, filtrez les caractères spéciaux non nécessaires, et implémentez une whitelist de valeurs autorisées si possible.

Alternatives à l’API Free Mobile

Si l’API Free Mobile ne correspond pas à vos besoins ou si vous n’êtes pas abonné Free, plusieurs alternatives existent sur le marché. Voici un comparatif des principales solutions.

Twilio

Twilio représente la référence mondiale des APIs SMS professionnelles. Le service propose une API extrêmement complète avec envoi vers n’importe quel numéro mondial, gestion des réponses, numéros virtuels, et infrastructure hautement disponible. Le tarif démarre autour de 0,06 euro par SMS pour la France, avec un crédit gratuit de test.

Cette solution convient parfaitement aux usages professionnels nécessitant volume, fiabilité et support technique. En revanche, le coût devient rapidement significatif pour un usage personnel intensif.

OVH SMS

OVH propose une API SMS compétitive avec des tarifs attractifs pour le marché français. Comptez environ 0,035 euro par SMS, sans frais d’abonnement. L’API s’intègre facilement et la documentation reste de qualité correcte, même si moins aboutie que celle de Twilio.

Services de notifications intégrés

Des services comme Pushover, Pushbullet ou Telegram peuvent constituer des alternatives intéressantes aux SMS pour des notifications personnelles. Concrètement, ces solutions offrent souvent plus de flexibilité que les SMS traditionnels : messages plus longs, images, liens cliquables, et coût nul ou très faible.

Telegram notamment permet de créer un bot gratuitement et d’envoyer des messages vers votre compte personnel sans aucune limitation. L’API reste très simple d’utilisation et la fiabilité s’avère excellente.

Solution	Coût	Avantages	Inconvénients
API Free Mobile	Gratuit	Gratuit Simple	Limité Free Volume restreint
Twilio	~0,06€/SMS	Professionnel Mondial	Coûteux Complexe
OVH SMS	~0,035€/SMS	Compétitif Français	Payant
Telegram Bot	Gratuit	Gratuit Illimité Riche	Nécessite app

Questions Fréquentes

L’API Free Mobile est-elle vraiment gratuite ?

Oui, l’API Free Mobile SMS est totalement gratuite pour tous les abonnés Free Mobile disposant d’un forfait actif. Il n’y a aucun frais caché ni limitation de durée. Le service fait partie intégrante de votre abonnement mobile Free, qu’il s’agisse d’un forfait payant ou du Forfait Free à 2 euros.

Puis-je envoyer des SMS vers d’autres numéros ?

Non, l’API Free Mobile permet uniquement d’envoyer des SMS vers votre propre numéro Free Mobile. Vous ne pouvez pas utiliser ce service pour envoyer des messages vers d’autres numéros, même Free. Cette limitation fait partie des conditions d’utilisation du service et vise à réserver l’API à un usage de notification personnelle.

Combien de SMS puis-je envoyer par jour ?

Free n’indique pas de quota officiel, mais la limite observée se situe autour de 200 à 250 SMS par jour. Cette limite reste amplement suffisante pour du monitoring de serveurs, des alertes domotiques ou des notifications d’applications personnelles. Au-delà de ce volume, il est préférable d’envisager une solution commerciale adaptée.

Que faire si mes SMS n’arrivent pas ?

Vérifiez d’abord que l’option « Notifications par SMS » est bien activée dans votre espace abonné Free Mobile. Contrôlez ensuite que votre identifiant utilisateur et votre clé API sont corrects. Testez avec une simple commande cURL pour isoler un éventuel problème de code. Enfin, assurez-vous de ne pas avoir dépassé le quota quotidien ou d’envoyer trop de messages rapprochés.

L’API fonctionne-t-elle à l’étranger ?

Oui, l’API Free Mobile fonctionne quel que soit votre emplacement géographique au moment de l’envoi de la requête HTTP. Vous pouvez déclencher l’envoi de SMS depuis n’importe où dans le monde, à condition d’avoir une connexion internet. Votre téléphone recevra le SMS même si vous êtes en itinérance à l’étranger, dans les limites de couverture réseau standard.

Conclusion : une solution simple et efficace pour vos notifications personnelles

L’API Free Mobile SMS constitue une solution gratuite, simple et fiable pour recevoir des notifications par SMS depuis vos applications, scripts et systèmes de monitoring. Son intégration nécessite seulement quelques lignes de code et fonctionne immédiatement une fois l’option activée dans votre espace abonné.

Certes, le service comporte des limitations importantes : envoi uniquement vers votre propre numéro, volume quotidien restreint, et absence de garantie de disponibilité. Soyons réalistes, ces contraintes éliminent tout usage professionnel ou commercial. En revanche, pour du monitoring personnel, de la domotique ou des alertes d’applications privées, l’API remplit parfaitement son rôle.

Dans les faits, la gratuité totale du service et sa simplicité d’utilisation en font un choix évident pour les abonnés Free Mobile qui cherchent une solution de notification fiable sans coût supplémentaire. Les exemples de code présentés dans ce guide vous permettent d’intégrer rapidement le service dans vos projets, quel que soit votre langage de programmation préféré.

Si vous avez besoin d’un volume plus important, d’envois vers plusieurs numéros, ou de garanties de disponibilité strictes, orientez-vous vers des solutions professionnelles comme Twilio ou OVH SMS. Pour tous les autres cas d’usage personnels, l’API Free Mobile représente un excellent compromis entre simplicité et efficacité.