antoninocanta/mysmsproject repository overview

⁠📨 OVH SMS Gateway (Docker)

Cette image Docker fournit une API HTTP GET ultra-légère, sans authentification ni TLS, qui sert de passerelle locale vers l’API sécurisée d’envoi de SMS d’OVH.
Idéale dans un réseau domestique de confiance (LAN) pour des équipements incapables de gérer HTTPS ou OAuth : Arduino, ESP32, centrale d’alarme, box domotique, etc.

⁠🚀 Fonctionnalités

• Implémentation Flask servie par Gunicorn (WORKERS parallèles).
• Appel unique en GET : /<endpoint>?to=<num>&message=<texte>
• Traduit cet appel en requête HTTPS vers l’API OVH (http2sms.cgi).
• Réponse HTML simplifiée : rappel des paramètres + retour OVH.

⁠🛠 Déploiement rapide

version: '3'
services:
  ovhsms:
    image: antoninocanta/mysmsproject:latest
    volumes:
      - ./myproject:/app/myproject
    container_name: ovhsms
    ports:
      - "8123:8000"        # hôte:conteneur
    environment:
      OVH_ACCOUNT: "monCompteOVH"
      OVH_LOGIN:   "apiLogin"
      OVH_PASSWORD:"apiPassword"
      OVH_FROM:    "MyHome"
      WORKERS:     "2"     # (optionnel) workers gunicorn

docker compose up -d

⁠🌐 Utilisation

1. Requête HTTP GET

GET http://<IP-serveur>:8123/ovhsmsapp?to=0033612345678&message=Capteur%20porte%20ouvert
to : numéro au format international (+33...) – URL-encodé
message : texte du SMS – URL-encodé

1. Exemple curl

curl "http://192.168.1.50:8123/ovhsmsapp?to=0033612345678&message=Test%20depuis%20curl"

1. Exemple Arduino / ESP32 (pseudocode)

WiFiClient client;
if (client.connect("192.168.1.50", 8123)) {
  String url = "/ovhsmsapp?to=0033612345678&message=Temp%20haute%21";
  client.print(String("GET ") + url + " HTTP/1.1\r\n" +
               "Host: 192.168.1.50\r\n" +
               "Connection: close\r\n\r\n");
}

⁠📋 Variables d’environnement

⁠Variable Obligatoire Description OVH_ACCOUNT oui Identifiant de compte OVH OVH_LOGIN oui Login API OVH (appKey) OVH_PASSWORD oui Mot de passe / clé secrète (appSecret) OVH_FROM oui Expéditeur alphanumérique du SMS WORKERS non Processus Gunicorn (défaut : 1)

⁠🏗 Architecture interne

Gunicorn lance WORKERS processus et expose Flask sur 0.0.0.0:8000.

Route GET /ovhsmsapp ↳ extrait to, message → décode → prépare requête OVH ↳ appelle https://www.ovh.com/cgi-bin/sms/http2sms.cgi⁠ (timeout 5 s).

Retourne la réponse OVH, utile pour debug.