Ajout de la vérification de l'état du serveur SMTP et mise à jour de la gestion des erreurs lors de l'envoi d'emails. Ajout des liens vers le projet et le profil GitHub dans le README.

Author: serge-eric-kalaga

README.md

@@ -142,6 +142,21 @@ Envoi d'un email
 }
 ```
 
+#### GET `/api/smtp-status`
+Vérification du statut du serveur SMTP
+
+**Réponse :**
+```json
+{
+  "status": true,
+  "message": "SMTP server is reachable."
+}
+```
+
+**États possibles :**
+- `status: true` : Le serveur SMTP est accessible et les identifiants sont valides
+- `status: false` : Le serveur SMTP n'est pas accessible ou les identifiants sont incorrects
+
 ## 💡 Exemples d'utilisation
 
 ### Envoi d'un email simple
@@ -244,6 +259,57 @@ sendEmail(
 );
 ```
 
+### Vérification du statut SMTP
+
+```bash
+# Vérifier si le serveur SMTP est accessible
+curl http://localhost:9876/api/smtp-status
+```
+
+**Réponse en cas de succès :**
+```json
+{
+  "status": true,
+  "message": "SMTP server is reachable."
+}
+```
+
+**Réponse en cas d'erreur :**
+```json
+{
+  "status": false,
+  "message": "SMTP server is not reachable."
+}
+```
+
+### Intégration du test SMTP en Python
+
+```python
+import requests
+
+def check_smtp_status():
+    try:
+        response = requests.get("http://localhost:9876/api/smtp-status")
+        data = response.json()
+        
+        if data["status"]:
+            print("✅ Serveur SMTP accessible")
+            return True
+        else:
+            print("❌ Serveur SMTP non accessible:", data["message"])
+            return False
+    except Exception as e:
+        print(f"Erreur lors de la vérification : {e}")
+        return False
+
+# Utilisation
+if check_smtp_status():
+    # Procéder à l'envoi d'emails
+    send_email("test@example.com", "Test", "Message de test")
+else:
+    print("Impossible d'envoyer des emails pour le moment")
+```
+
 ## 🔧 Gestion des erreurs
 
 ### Codes de statut HTTP
@@ -272,10 +338,52 @@ sendEmail(
 }
 ```
 
+## 📊 Diagnostic et monitoring
+
+### Vérification de l'état du service
+
+```bash
+# Vérifier que le service répond
+curl http://localhost:9876/
+
+# Vérifier la documentation API
+curl http://localhost:9876/docs
+
+# Tester la connectivité SMTP
+curl http://localhost:9876/api/smtp-status
+```
+
+```bash
+# Test d'envoi d'email (optionnel)
+echo "3. Test d'envoi d'email de diagnostic..."
+curl -X POST "http://localhost:9876/api/send-email" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "receiver_email": "admin@votre-domaine.com",
+    "email_object": "Test de diagnostic - Mail Service",
+    "message_text": "Ce message confirme que le service fonctionne correctement."
+  }'
+
+echo "=== Fin du diagnostic ==="
+```
+
+## 🚨 Sécurité et bonnes pratiques
+
+### Recommandations de sécurité
+
+1. **Utilisez des mots de passe d'application** pour Gmail (pas votre mot de passe principal)
+2. **Limitez l'accès** au port 9876 dans votre pare-feu
+3. **Utilisez HTTPS** en production avec un reverse proxy (nginx, traefik)
+4. **Stockez les secrets** de manière sécurisée (Docker secrets, variables d'environnement chiffrées)
+5. **Surveillez régulièrement** le statut SMTP avec l'endpoint `/api/smtp-status`
+
 
 ---
 
 
 **Développé avec ❤️ par Kalaga Serge**
 
-Pour plus d'informations, consultez la documentation API interactive à l'adresse `http://localhost:9876/docs`
+<!-- Mes coordonnées Github -->
+
+- [Projet GitHub](https://github.com/serge-eric-kalaga/MailService)
+- [Profil GitHub - serge-eric-kalaga](https://github.com/serge-eric-kalaga)

api.py

@@ -1,7 +1,10 @@
 from fastapi import APIRouter, Body, HTTPException
 from fastapi.responses import JSONResponse
 from pydantic import BaseModel
-from utils import send_email
+from utils import send_email, get_smtp_server_status
+
+
+router = APIRouter()
 
 
 class EmailRequest(BaseModel):
@@ -13,7 +16,9 @@ class EmailRequest(BaseModel):
     message_text: str = Body(..., description="Content of the email")
 
 
-router = APIRouter()
+class ServerStatusResponse(BaseModel):
+    status: bool
+    message: str
 
 
 @router.post("/send-email")
@@ -52,3 +57,20 @@ async def send_email_endpoint(email_request: EmailRequest):
     if not success:
         raise HTTPException(status_code=500, detail="Error sending email")
     return JSONResponse(content={"message": "Email sent successfully"})
+
+
+@router.get("/smtp-status", response_model=ServerStatusResponse)
+async def smtp_status():
+    """
+    Endpoint to check the status of the SMTP server.
+    Returns a message indicating whether the SMTP server is reachable or not.
+    """
+    try:
+        status = get_smtp_server_status()
+        message = (
+            "SMTP server is reachable." if status else "SMTP server is not reachable."
+        )
+        return ServerStatusResponse(status=status, message=message)
+    except Exception as e:
+        message = f"Error checking SMTP server status: {e}"
+        return ServerStatusResponse(status=False, message=message)

utils.py

@@ -87,4 +87,22 @@ def send_email(receiver_email: str | list[str], message_text: str, email_object:
             return True
     except Exception as e:
         print(f"Error, unable to send email {e}")
-        raise HTTPException(status_code=500, detail=f"Error sending email: {e}")
+        raise HTTPException(status_code=400, detail=f"Error sending email: {e}")
+
+
+def get_smtp_server_status() -> bool:
+    settings = SETTINGS
+    EMAIL_HOST = settings.EMAIL_HOST
+    EMAIL_PORT = settings.EMAIL_PORT
+    EMAIL_USERNAME = settings.EMAIL_USERNAME
+    EMAIL_PASSWORD = settings.EMAIL_PASSWORD
+
+    try:
+        with smtplib.SMTP(EMAIL_HOST, EMAIL_PORT, timeout=10) as server:
+            server.starttls()
+            server.login(user=EMAIL_USERNAME, password=EMAIL_PASSWORD)
+            server.noop()
+            return True
+    except Exception as e:
+        print(f"SMTP server connection failed: {e}")
+        raise e