Dokumentation

Drei Endpunkte und kein Konto. Es gibt nicht viel zu lernen, also gibt es auch nicht viel zu lesen.

Hier beginnen

Ein funktionierendes Postfach und eine ausgelesene Nachricht, in vier Befehlen. Beginnen Sie hier, wenn Sie die API noch nie aufgerufen haben.

Alle drei Endpunkte mit Parametern, Beispielen und Statuscodes. Der vollständige Vertrag.

Ratenlimit, Nachrichtengröße, Aufbewahrung und alles andere, was begrenzt ist. Kurze Seite, keine Überraschungen.

Ein Postfach wird nicht angelegt: Es gibt keinen „Adresse erstellen“-Aufruf. Eine Adresse existiert in dem Moment, in dem Mail bei ihr eintrifft, und hört auf zu existieren, wenn die letzte Nachricht abläuft.
Die Adresse ist der Zugangsschlüssel: Auf einer öffentlichen Domain kann jeder, der die Adresse kennt, sie lesen – über die API genauso wie über die Website. Nutzen Sie Ihre eigene Domain, wenn das nicht akzeptabel ist.
Alles läuft ab: Nachrichten werden 5 Tage nach Eingang gelöscht. expires_at steht in jeder Nachricht, damit Sie es nie selbst berechnen müssen.
Nur Empfang: Kein Endpunkt versendet Mail. Das ist Absicht: Es verhindert, dass ein kostenloser, unauthentifizierter Dienst zum Spam-Relay wird.

Verhält sich ein Aufruf abweichend von dieser Dokumentation, ist die Dokumentation der Fehler — sagen Sie uns Bescheid, dann wird es korrigiert.

Mail kommt nie an: Prüfen Sie zuerst den MX-Eintrag: smtp.grabmail.io und sonst nichts. Ein übrig gebliebener MX-Eintrag eines früheren Anbieters zieht still einen Teil Ihres Traffics ab.
Die API antwortet mit 404: Entweder ist die Domain nicht hierher ausgerichtet, oder die Nachricht hat ihre Aufbewahrungsfrist überschritten. Die beiden Fälle unterscheidet der error-Slug.
Mail gibt vor, von uns zu stammen: Sie ist gefälscht. Von hier kann keine E-Mail versendet werden — unser SPF ist v=spf1 -all und unser DMARC ist p=reject, was jedem empfangenden Server auf der Welt sagt, sie zu verwerfen.