Documentation
Trois points de terminaison et aucun compte. Il n’y a pas grand-chose à apprendre, donc pas grand-chose à lire.
Commencer ici
Démarrage rapide
Une boîte de messagerie fonctionnelle et un message relu, en quatre commandes. Commencez ici si vous n'avez jamais appelé l'API.
Référence API
Les trois points d'accès avec paramètres, exemples et codes de statut. Le contrat, en intégralité.
Limites
Limite de débit, taille des messages, rétention et tout ce qui est plafonné. Page courte, aucune surprise.
Guides
Des parcours plus longs, avec les cas d'échec inclus : quoi faire plutôt que ce que signifie un paramètre.
Combien de temps dure une boîte
Ce à quoi s’applique la fenêtre de 5 jours et ce à quoi elle ne s’applique pas, quand l’horloge démarre réellement, tout ce qui part avec un message, comment lire l’échéance directement depuis l’API, et l’habitude qui rend tout cela sans importance.
Le mail jetable, expliqué
La définition, la mécanique (un enregistrement MX et une boîte qui existe dès le premier message), mail jetable contre alias, burner et adresse temporaire, les bons usages, les quatre cas où c'est le mauvais outil, et la durée de vie d'une adresse.
Tests d'e-mails avec Playwright
Une fixture qui ouvre une boîte neuve par test, une attente bornée par une échéance plutôt qu'un nombre d'essais, des extracteurs ancrés sur votre propre modèle, trois parcours complets (code, lien magique, réinitialisation) et la CI sans secret.
Les quatre choses à savoir
- Une boîte de messagerie n'est pas créée
- Il n’y a pas d’appel « créer une adresse ». Une adresse existe dès qu’un courrier lui parvient, et cesse d’exister quand le dernier message expire.
- L'adresse est l'identifiant
- Sur un domaine public, quiconque connaît l'adresse peut la lire — via l'API exactement comme via le site. Utilisez votre propre domaine quand cela n'est pas acceptable.
- Tout expire
- Les messages sont supprimés 5 jours après leur arrivée.
expires_atfigure sur chaque message pour que vous n'ayez jamais à le calculer. - Réception uniquement
- Aucun point d'accès n'envoie de courrier. C'est volontaire : c'est ce qui empêche un service gratuit et non authentifié de devenir un relais de spam.
Quand quelque chose ne va pas
Si un appel se comporte différemment de cette documentation, c'est la documentation qui est en tort — signalez-le et ce sera corrigé.
- Le courrier n'arrive jamais
- Vérifiez d'abord l'enregistrement MX :
smtp.grabmail.ioet rien d'autre. Un MX oublié d'un ancien fournisseur détourne une partie de votre trafic sans prévenir. - L'API répond 404
- Soit le domaine n'est pas pointé ici, soit le message a dépassé sa durée de conservation. Les deux cas se distinguent par le slug
error. - Un e-mail prétend venir de nous
- Il est falsifié. Rien ici ne peut envoyer d'e-mail — notre SPF est
v=spf1 -allet notre DMARC estp=reject, ce qui indique à chaque serveur receveur sur terre de le jeter.