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.
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.