Auflisten und abrufen
Nachrichten finden und sehen, was aus einer geworden ist.
Führt jeden der 3 Aufrufe auf dieser Seite gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
Auflisten
GET /emails, neueste zuerst. Filtern mit status (kommagetrennt) und from. Die Seitenaufteilung erfolgt per Keyset, nicht per offset: Geben Sie den nextCursor zurück, den Sie erhalten haben. Offset-Paging überspringt stillschweigend Zeilen, wenn während des Blätterns neue Nachrichten eintreffen.
{ "object": "list", "data": [ … ], "hasMore": true, "nextCursor": "msg_01j8…" }Eine Zeile, die getrackt wurde, trägt zusätzlich ein kompaktes tracking-Objekt: opens, clicks, opened, clicked, openCount, clickCount, firstOpenAt. Eine Zeile, die nicht getrackt wurde, trägt überhaupt keinen tracking-Schlüssel: openCount: 0 bei einer Nachricht, die nie ein Pixel enthielt, liest sich als „niemand hat sie geöffnet“, und das ist eine Aussage, die wir gar nicht treffen können.
Eine einzelne abrufen
GET /emails/{id} gibt die Nachricht mit dem Zustellstatus pro Empfänger zurück sowie den VOLLSTÄNDIGEN Tracking-Bericht statt der Zusammenfassung aus der Liste, denn ein einzelner Abruf kann sich die Aufschlüsselung pro Empfänger und die Links leisten. Eine id, die es nicht gibt, ergibt ein 404, niemals einen erfundenen Erfolg.
| Empfängerstatus | Bedeutet |
|---|---|
| pending | Noch nicht übertragen. |
| delivered | An den Transport für diese Adresse übergeben. |
| failed | Der Transport hat sie abgelehnt. |
| uncertain | Ein Transport ist auf halbem Weg gescheitert und kann nicht sagen, welche Empfänger er erreicht hat. Wird als eigener Zustand ausgewiesen, statt in die eine oder andere Richtung geraten zu werden. |
Ereignisse
GET /emails/{id}/events gibt die Spur zurück, älteste zuerst: email.accepted, email.queued, email.scheduled, email.sent, email.failed, email.cancelled, email.rescheduled und, bei einer getrackten Nachricht, email.opened, email.clicked und email.downloaded, sobald sie eintreten. Wer benachrichtigt werden will, statt danach zu fragen, registriert einen Webhook.