Einen Posteingang erstellen

Body

domainstring

Eine aus `GET /temp-mail/domains`. Lassen Sie sie weg, wählt der Pool zufällig, statt die erste Domain zu füllen. Eine Domain, die jede Wegwerf-Anmeldung im Internet empfängt, verdient sich die passende Reputation, und diese Reputation teilt sich jede Adresse darauf. Eine Domain, die nicht im Pool ist, wird namentlich abgelehnt (422 `unknown_domain`) statt stillschweigend ersetzt, denn Sie hätten die angeforderte Adresse bereits kopiert.

localPartstring

Der Teil vor dem @, falls Sie ihn wählen wollen: 3 bis 32 Zeichen aus Buchstaben, Ziffern, Punkten, Bindestrichen und Unterstrichen, beginnend und endend mit einem Buchstaben oder einer Ziffer. Enger, als RFC 5321 erlaubt, denn dieser String geht in einen URL-Pfad, einen `To:`-Header und eine HTML-Seite. `+` ist ausgeschlossen, da Sub-Adressierung beim Eingang zusammengefasst wird und `alice+bob` daher ein Name wäre, unter dem Sie gar nicht erreichbar sind. Bereits vergebene Namen antworten mit 409 `address_taken`, was zwei Fälle abdeckt: Ein anderer Besucher hält ihn (oder hielt ihn innerhalb der letzten Woche, solange die Adresse noch aus dem Verkehr gezogen ist), und der Eigentümer der Domain hat ihn als echte Adresse angelegt, was unter demselben Code abgelehnt wird, weil Mail dorthin ihn erreicht und nie Sie. `postmaster` und die anderen reservierten Namen antworten mit 422 `reserved_address`.

ttlMinutesnumber

Wie lang die Laufzeit sein soll, in Minuten, von 1 bis 1440. Standard ist 60. Alles außerhalb dieses Bereichs antwortet mit 422 `invalid_parameter` und nennt das Feld, statt still angepasst zu werden. Sie hätten jemandem bereits den angeforderten Ablauf gezeigt. Die 24 Stunden werden ab der Erstellung gemessen, jede vorab genommene Stunde ist also eine Verlängerung, die später nicht mehr ausgegeben werden kann: `ttlMinutes: 120` kommt mit 22 davon zurück und 1440 mit keiner.

idstring

Die Posteingangs-ID, `tinb_` und vierundzwanzig Hex-Zeichen. Sie steht im Pfad jedes anderen Aufrufs und ist kein Geheimnis. Das Token schon.

addressstring

Die Adresse, die Sie weitergeben. Mail an `that+anything@` erreicht sie ebenfalls, weil Sub-Adressierung vor der Suche zusammengefasst wird.

domainstring

Die Pool-Domain, auf der die Adresse liegt, separat ausgewiesen, damit ein Client die Adresse zum Anzeigen nicht parsen muss.

createdAtstring

ISO-8601. Die 24-Stunden-Obergrenze wird hiervon aus gemessen, nicht ab der letzten Verlängerung.

expiresAtstring

ISO-8601. Danach authentifiziert das Token sofort nicht mehr, und der Aufräumlauf löscht die Mail beim nächsten Durchgang.

extensionsLeftnumber

Wie oft `extend` tatsächlich noch Zeit dazukauft, unter Berücksichtigung beider Obergrenzen: der 23 Verlängerungen, die eine Laufzeit erlaubt, und der 24 Stunden ab `createdAt`, über die sie nie hinauslaufen kann, je nachdem, was zuerst erreicht wird. Ein mit `ttlMinutes: 1440` erstellter Posteingang meldet 0, ohne etwas verbraucht zu haben. Null bedeutet, dass der Aufruf mit 409 antworten würde, und darauf sollte ein Client den Button ausgrauen, statt es durch Drücken herauszufinden.

messageCountnumber

Nachrichten, die dieser Posteingang ANGENOMMEN hat, nicht wie viele angezeigt werden. Der Wert sinkt nicht, wenn Sie eine löschen: Die Obergrenze zählt Eingänge, Löschen gibt also Speicher frei, aber keinen Platz.

messageLimitnumber

Die Obergrenze, mit jedem Posteingang mitgesendet, damit ein Client „voll“ sagen kann, ohne unsere Konstante fest einzucodieren.

lastMessageAtstring | null

Wann zuletzt Mail eingegangen ist, ISO-8601, oder null, wenn noch keine kam. Für jemanden, der zwei Minuten wartet, liest sich null bei einem frischen Posteingang ganz anders als bei einem stillen.

tokenstring

Das Credential, in dieser Antwort und in keiner anderen. `oe_inbox_` und 43 base64url-Zeichen; die Zeile speichert nur einen mit Schlüssel gebildeten Hash, es lässt sich also weder erneut lesen noch wiederherstellen.