SMTPy pour les développeurs : infrastructure email as code

Pourquoi les développeurs choisissent SMTPy

La gestion email dans les applications est traditionnellement compliquée : SendGrid pour le transactionnel, Postfix pour la réception, un service tiers pour les alias... SMTPy consolide tout ça dans une API cohérente.

API REST : exemples de code

Créer un alias

curl -X POST https://smtpy.fr/api/v1/aliases \
  -H "X-API-Key: votre-cle-api" \
  -H "Content-Type: application/json" \
  -d '{"local": "user-123", "domain_id": 1, "forward_to": "user@example.com"}'

Lister les messages d'un alias

curl https://smtpy.fr/api/v1/messages?alias_id=42 \
  -H "X-API-Key: votre-cle-api"

Webhooks : traitement temps réel

Configurez une URL de webhook pour recevoir les emails en temps réel :

// Payload reçu sur votre endpoint
{
  "event": "email.received",
  "alias": "contact@votredomaine.fr",
  "from": "client@example.com",
  "subject": "Demande de devis",
  "body_text": "Bonjour...",
  "received_at": "2026-03-10T14:23:00Z"
}

MCP Server : intégration avec les assistants IA

SMTPy expose un MCP Server compatible avec Claude, GPT-4 et autres LLM. Vos assistants IA peuvent :

• Lire et résumer les emails entrants
• Créer des alias à la demande
• Analyser les statistiques de délivrabilité
• Répondre à des emails depuis l'assistant

Configuration MCP dans claude_desktop_config.json :

{
  "mcpServers": {
    "smtpy": {
      "command": "npx",
      "args": ["-y", "smtpy-mcp"],
      "env": {
        "SMTPY_API_KEY": "votre-cle-api",
        "SMTPY_URL": "https://smtpy.fr"
      }
    }
  }
}

Cas d'usage SaaS : alias par utilisateur

Pour une application SaaS où chaque utilisateur doit avoir sa propre boîte mail :

# Python — créer un alias lors de l'inscription d'un utilisateur
import httpx

def create_user_email(username: str, user_email: str) -> str:
    alias_local = f"user-{username}"
    response = httpx.post(
        "https://smtpy.fr/api/v1/aliases",
        headers={"X-API-Key": SMTPY_API_KEY},
        json={
            "local": alias_local,
            "domain_id": YOUR_DOMAIN_ID,
            "forward_to": user_email
        }
    )
    return f"{alias_local}@votredomaine.fr"

Tests email en développement

Créez des alias temporaires pour vos tests :

• test-signup-TIMESTAMP@votredomaine.fr pour tester le flux d'inscription
• test-reset-TIMESTAMP@votredomaine.fr pour tester la réinitialisation de mot de passe
• Désactivez les alias de test après chaque session