Dokumentation
Drei Endpunkte und kein Konto. Es gibt nicht viel zu lernen, also gibt es auch nicht viel zu lesen.
Hier beginnen
Schnellstart
Ein funktionierendes Postfach und eine ausgelesene Nachricht, in vier Befehlen. Beginnen Sie hier, wenn Sie die API noch nie aufgerufen haben.
API-Referenz
Alle drei Endpunkte mit Parametern, Beispielen und Statuscodes. Der vollständige Vertrag.
Limits
Ratenlimit, Nachrichtengröße, Aufbewahrung und alles andere, was begrenzt ist. Kurze Seite, keine Überraschungen.
Anleitungen
Längere Anleitungen, mit den Fehlerfällen darin: was zu tun ist, nicht was ein Parameter bedeutet.
Wie lange ein Posteingang hält
Worauf sich das 5-Tage-Fenster bezieht und worauf nicht, wann die Uhr wirklich zu laufen beginnt, alles, was mit einer Nachricht mitgeht, die Frist direkt aus der API lesen, und die Gewohnheit, durch die nichts davon mehr eine Rolle spielt.
Was Temp Mail ist
Die Definition, die Mechanik (ein MX-Eintrag und ein Postfach, das mit der ersten Nachricht entsteht), Temp Mail gegenüber Wegwerf-, Burner- und Alias-Adressen, wofür sie taugt, die vier Fälle, in denen sie das falsche Werkzeug ist, und wie lange eine Adresse lebt.
E-Mail-Tests in Playwright
Eine Fixture, die pro Test ein neues Postfach öffnet, eine Wartezeit mit Uhrzeit-Frist statt Retry-Zähler, Extraktoren, die auf Ihrem eigenen Template verankert sind, drei vollständige Abläufe (Code, Magic Link, Passwort-Reset) und der Betrieb in CI ohne Secret.
Die vier Dinge, die man wissen sollte
- 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_atsteht 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.
Wenn etwas nicht stimmt
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.iound 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 -allund unser DMARC istp=reject, was jedem empfangenden Server auf der Welt sagt, sie zu verwerfen.