Versand und Betrieb
Einen E-Mail in die Warteschlange stellen
Erhalten Sie die Box ID von GET /v1/mailboxes.. Erstellen Sie eine eindeutige Idempotency-Key für eine Einreichung und speichern Sie sie bis zum Endergebnis. Verwenden Sie für die Netzwerkwiedergabe denselben Schlüssel und denselben Textkörper.
HTTP 202 gibt ein Vorgangsobjekt zurück, keine Lieferbestätigung. Feld id enthält ID Operationen. Umfrage GET /v1/operations/{operation_id}.
POST /v1/mailboxes/42/sendIdempotency-Key: message-20261019-0001Content-Type: application/json
{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}So verstehen Sie das Ergebnis
queued- Der Brief wartet auf den Versand.
running- Der Versand läuft.
succeeded- Der Mailserver hat die Übermittlung akzeptiert. Überprüfen Sie das Ergebnis für jeden Empfänger.
failed- Das Senden ist fehlgeschlagen. Der Grund wird in error. angegeben.
cancelled- Versand abgebrochen.
uncertain- Das Sendeergebnis konnte nicht bestätigt werden. Bitte überprüfen Sie den Vorgang und Ihren gesendeten Ordner, bevor Sie es erneut versuchen.
Nach einem erfolgreichen Versand enthält das Feld result accepted_recipients – akzeptierte Empfänger, rejected_recipients – abgelehnte Empfänger und sent_saved – das Ergebnis der Speicherung einer Kopie im Versand. Die Annahme eines Briefes durch einen Mailserver garantiert nicht die Zustellung im Posteingang des Empfängers.
Um einen ausstehenden Versand abzubrechen, führen Sie POST /v1/operations/{operation_id}/cancel. aus. Die Methode /retry sendet die E-Mail nicht erneut.
Antworten, Weiterleiten und verzögerter Versand
Um zu antworten, fügen Sie bitte message_id der ursprünglichen E-Mail in reply_to_message_id ein und leiten Sie sie an references. weiter. Geben Sie in to die Antwortadresse von reply_to oder die Adresse des Absenders ein. Um allen zu antworten, fügen Sie weitere Teilnehmer zu to und cc hinzu, ohne Ihre eigene Adresse.
Um Anhänge weiterzuleiten, übergeben Sie forward_message mit folder, uidvalidity und uid.. Für Ihre hochgeladenen Dateien verwenden Sie file_ids.. Die Gesamtgröße des Anhangs ist auf 25 MiB begrenzt.
send_at wird mit einer Zeitzone angegeben, die in UTC gespeichert ist; Ein verzögerter Versand ist innerhalb eines Jahres möglich. Grenzwerte werden beim tatsächlichen Senden überprüft, nicht bei der Erstellung einer Warteschlange.