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.

Voir le guide de démarrage →

Référence API

Les trois points d'accès avec paramètres, exemples et codes de statut. Le contrat, en intégralité.

Voir la référence →

Limites

Limite de débit, taille des messages, rétention et tout ce qui est plafonné. Page courte, aucune surprise.

Voir les limites →

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_at figure 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.io et 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 -all et notre DMARC est p=reject, ce qui indique à chaque serveur receveur sur terre de le jeter.