Mail Relay

Ce que fait Mail Relay

Votre application décrit un message, Pierrr l'expédie. Elle ne détient jamais d'identifiants d'envoi : un conteneur compromis ne peut donc pas écrire au nom de n'importe qui. Mail Relay sert aux e-mails transactionnels : lien de connexion, réinitialisation de mot de passe, reçu, notification liée à une action de la personne destinataire.

Mail Relay n'est pas fait pour la newsletter ni pour l'envoi en masse. Un projet dont les e-mails sont massivement signalés comme indésirables ou non remis voit son envoi suspendu.

Envoyer un e-mail

Depuis un conteneur de votre projet, envoyez une requête POST au relais de mail de Pierrr. L'adresse du relais est celle de votre réseau de projet ; le projet qui envoie est reconnu automatiquement, vous n'avez rien à déclarer.

Le corps est du JSON : `to` (un destinataire), `subject`, `text`, et facultativement `html`, `fromName` (le nom affiché) et `attachments`. L'adresse d'expédition est celle de Pierrr ; seul le nom affiché change.

Ajoutez une clé `idempotencyKey` : rejouer un appel après un délai dépassé rend l'envoi d'origine au lieu d'expédier un second lien de connexion, et ne compte pas dans votre quota.

Sur votre propre serveur

Un projet qui tourne sur un serveur relié par Pierrr Agent envoie ses e-mails exactement de la même façon : même adresse de relais, même corps de requête, même quota mensuel partagé par l'organisation, mêmes codes de réponse. Rien à changer dans votre code en passant d'un hébergement à l'autre.

Sur votre serveur, le relais est installé par l'agent et n'écoute que sur les réseaux de vos projets : aucun port n'est ouvert sur Internet. Chaque message part vers Pierrr par la connexion chiffrée de l'agent, et Pierrr vérifie que le projet qui écrit tourne bien sur ce serveur. Le débit est limité par projet sur le serveur, puis par le quota de votre plan.

Il faut une version récente de l'agent : tant qu'elle n'est pas installée, l'onglet Réseaux du projet le signale et propose la mise à jour.

Quota mensuel

Chaque plan inclut un nombre d'e-mails par mois : 50 sur Free, 1 000 sur Starter, 3 000 sur Pro, 10 000 sur Business. Le compteur est partagé par tous les projets de l'organisation et repart à zéro le 1er de chaque mois à 00:00 UTC.

Un e-mail compte quand il est accepté. Un envoi qui échoue chez nous ne consomme rien, un rejeu avec la même clé non plus.

À 80 % puis à 100 %, les propriétaires, les mainteneurs et le rôle facturation de l'organisation sont prévenus dans l'application et par e-mail. Vous suivez l'usage dans l'onglet Réseaux de vos projets.

Quand le quota est atteint, les envois suivants sont refusés avec le statut 429 et le code `quota_exceeded`. La réponse indique le compteur, la limite et la date de reprise (`resetsAt`), et l'en-tête `Retry-After` donne le délai en secondes. Un plan supérieur rétablit l'envoi tout de suite.

Le plan Free

Le plan Free inclut Mail Relay avec quelques garde-fous, qui protègent la délivrabilité de tous :

• le propriétaire de l'organisation a vérifié son adresse e-mail, et le projet a déjà été déployé avec succès ;
• des limites de débit et de destinataires s'appliquent sur le plan Free pour protéger la réputation d'envoi ;
• un envoi refusé pour cette raison l'est avec un code explicite, et l'en-tête `Retry-After` indique quand réessayer ;
• le nom affiché ne peut pas reprendre celui de Pierrr ni celui d'une marque courante.

Codes de réponse

Un envoi refusé l'est toujours explicitement, avec un code stable dans `reason`.

• 201 : accepté, l'identifiant du message est rendu.
• 400 : pièce jointe refusée (`invalid_attachment`) ou nom affiché refusé (`reserved_sender`).
• 403 : projet non éligible (`not_eligible`) ou envoi suspendu (`suspended`).
• 429 : quota mensuel atteint (`quota_exceeded`), débit du plan Free dépassé (`rate_limited`, avec `Retry-After`) ou trop de destinataires différents (`too_many_recipients`).
• 502 : le message n'a pas pu être remis à notre transporteur ; 503 : l'envoi n'est pas disponible.

Pièces jointes

Jusqu'à 5 pièces jointes, 500 ko chacune et 700 ko au total. Types acceptés : PDF, texte, CSV, JSON, PNG, JPEG, GIF et WebP. Le contenu est vérifié par rapport au type annoncé, et les pages HTML ou les archives sont refusées.

Ce que Pierrr conserve

Seulement des métadonnées : projet, destinataire, statut et identifiant du message. Jamais le sujet ni le contenu, puisqu'ils portent des liens de connexion valides. Ces métadonnées sont supprimées au bout de 30 jours.