Envoi de SMS avec l’API Free Mobile

Envoyer des SMS automatiquement depuis un script Python peut s’avérer extrêmement utile dans de nombreux cas : surveillance de serveurs, alertes de domotique, rappels personnels, notifications système, etc. Si vous êtes client Free Mobile, bonne nouvelle : vous pouvez le faire gratuitement grâce à leur API SMS.

Dans cet article, nous allons voir comment utiliser cette API simplement avec un petit script Python. C’est rapide, efficace et entièrement gratuit pour les abonnés Free Mobile.


🚀 L’objectif

Nous allons écrire une fonction Python send_sms() qui :

  • envoie un SMS via l’API Free Mobile,
  • prend en paramètre l’identifiant utilisateur, la clé API, et le message,
  • gère les erreurs réseau ou API.

📜 Le script Python

Voici le code complet :

Python

🛠️ Explication du code

  • import requests : On utilise la bibliothèque requests pour envoyer une requête HTTP à l’API.
  • send_sms(id, apikey, message) : La fonction principale qui envoie le message.
  • url = ... : On construit l’URL en insérant l’identifiant, la clé API et le contenu du SMS.
  • requests.get(url) : On effectue l’appel HTTP GET vers l’API de Free Mobile.
  • status_code : On récupère le code de réponse HTTP pour savoir si tout s’est bien passé.

Si une exception survient (ex : pas d’Internet, mauvais identifiants), elle est retournée pour que le développeur puisse la gérer proprement.


✅ Réponse de l’API : que signifient les codes ?

Voici quelques codes que vous pouvez rencontrer :

  • 200 : Succès, le SMS a été envoyé.
  • 400 : Paramètre invalide (ex : message vide).
  • 402 : Trop de SMS envoyés en peu de temps.
  • 403 : Identifiants invalides.
  • 500 : Erreur serveur.

🔐 Où obtenir l’identifiant et la clé API ?

Pour utiliser cette API, vous devez être client Free Mobile. Voici les étapes à suivre :

  1. Connectez-vous à votre espace abonné Free Mobile.
  2. Allez dans « Mes options ».
  3. Activez « Notification par SMS ».
  4. Vous obtiendrez :
    • votre identifiant utilisateur (user),
    • votre clé API (pass).

⚠️ Ne partagez jamais ces informations ! Elles permettent d’envoyer des messages depuis votre compte.


💡 Astuces d’utilisation

Vous pouvez facilement intégrer ce script :

  • dans un script cron pour notifier une tâche terminée,
  • dans un système de surveillance pour alerter en cas de coupure,
  • dans un assistant domotique pour vous prévenir d’un changement d’état,
  • ou pour simplement vous envoyer un rappel personnel automatisé.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *