Mail

Envoi depuis votre domaine

Par défaut, Restaurateur.ch envoie les emails depuis noreply@restaurateur.ch. Branchez votre propre domaine pour que vos clients reçoivent des emails au look de votre marque.

Comment ça marche

  1. Créez un compte sur SwissApp Mail et vérifiez votre domaine (DKIM/SPF/DMARC)
  2. Récupérez votre clé API SwissApp Mail
  3. Enregistrez-la via PUT /mail avec votre sender_email
  4. Lancez POST /mail/verify pour envoyer un test à restaurant.email
  5. Si réussi, tous les futurs emails seront envoyés depuis votre domaine

Lire la config

GET/api/v1/mail

Retourne la config actuelle, sans exposer la clé API (juste les 4 derniers caractères pour vérif).

json 
{
  "mail": {
    "configured": true,
    "verified": true,
    "sender_email": "noreply@mrpickwick.ch",
    "api_key_last4": "8a9b",
    "verified_at": "2026-06-05 14:30:00",
    "last_test_at": "2026-06-05 14:30:00",
    "last_test_error": null
  }
}

Enregistrer la clé

PUT/api/v1/mail
ChampTypeNotes
api_keystringrequired Clé SwissApp Mail
sender_emailstringrequired Ex: noreply@votredomaine.ch
bash 
curl -X PUT https://api.restaurateur.ch/api/v1/mail \
  -H "X-API-Key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "sm_live_xxxxxxxxxxxxxxxx",
    "sender_email": "noreply@mrpickwick.ch"
  }'
État après PUT : configured: true mais verified: false. Les emails continuent à partir de noreply@restaurateur.ch jusqu'à vérification.

Vérifier la clé

POST/api/v1/mail/verify

Envoie un email de test à restaurant.email via votre clé. Si succès → verified: true.

bash 
curl -X POST https://api.restaurateur.ch/api/v1/mail/verify \
  -H "X-API-Key: VOTRE_CLE_API"
json 
{
  "ok": true,
  "verified_at": "2026-06-05 14:30:00",
  "test_message_id": "abc123…"
}

En cas d'échec, la réponse contient { "ok": false, "error": "..." } avec le détail de l'erreur SwissApp Mail.

Effacer la config

DELETE/api/v1/mail

Repasse l'envoi sur noreply@restaurateur.ch. La clé est effacée définitivement.

bash 
curl -X DELETE https://api.restaurateur.ch/api/v1/mail \
  -H "X-API-Key: VOTRE_CLE_API"

Voir aussi