Logs
Wissen, was mit jeder E-Mail passiert ist
Durchsuchen Sie Ihre Zustellungen nach Status, Empfänger, Betreff und Datum, lesen Sie jede E-Mail per ID und beobachten Sie Bounces, sobald sie eintreffen, alles über einen einzigen Endpoint.
- JSON-Befehle
- 50 pro Seite
- Filtern und suchen
- Letzte 60 Tage
- Nur Lesezugriff
https://g.sendcorex.com/v1/logslogs:readSo funktioniert es
Ein Log pro E-Mail
Jede E-Mail, die Sie senden, erhält ein Log mit Empfänger, Betreff, Status und der Antwort des Empfängerservers. Die ID ist dieselbe, die Sie beim Senden erhalten haben.
Ein Endpoint, zwei Befehle
list_logs durchsucht und paginiert Ihre Logs; get_logs liest sie per ID. Beide gehen an POST /v1/logs, bis zu 20 Befehle pro Request.
Für Polling gemacht
Fragen Sie alle paar Sekunden nach neuen Bounces, ohne sich um Last zu sorgen: wiederholte Lesezugriffe teilen sich ein Ergebnis, und Warm-up-E-Mails stören nie.
Erste Schritte
Vor Ihrem ersten Request brauchen Sie nur den Key.
- 1
API key mit logs:read erstellen
Öffnen Sie im Dashboard Developers → API Keys und erstellen Sie einen Key mit dem Scope logs:read. Sie können ihn auch einem Key hinzufügen, den Sie bereits zum Senden verwenden.
Der Webmail-Token funktioniert hier nicht. Logs verwenden den API key aus dem Dashboard.
- 2
Logs durchsuchen
List Logs akzeptiert jede Kombination aus Status, Empfänger, Betreffwörtern, Domain, Absender und Datum und liefert 50 Logs pro Seite.
- 3
Eine E-Mail lesen
Get Logs liest bis zu 50 Logs per ID. Fügen Sie include_content hinzu, um das zugestellte HTML zu sehen.
Das Log
Beide Befehle liefern Logs in dieser Struktur.
{
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"to": "ana@acme.com",
"from": "noreply@yourdomain.com",
"domain": "acme.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "delivered",
"status_code": 2,
"response": "250 2.0.0 OK 1760684401 a1si123456",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Y1L-20261017",
"sent_at": "2026-10-17T06:00:01.204Z",
"updated_at": "2026-10-17T06:00:02.913Z"
}statusdelivered, bounced, spam oder rate_limited. Filtern Sie nach einem oder mehreren.
responseDie genaue Antwort des Empfängerservers. Bei einem Bounce steht dort der Grund.
blockedtrue, wenn Sendcorex nicht an diese Adresse gesendet hat, zum Beispiel weil sie unterdrückt ist.
contentStandardmäßig nicht Teil des Logs. Get Logs liefert das HTML mit include_content.
Ihr erster Request
Zwei Suchen in einem Request: Ihre Bounces dieses Monats und die letzten E-Mails an einen Kunden. Ersetzen Sie SENDCOREX_API_KEY durch Ihren API key.
curl -X POST 'https://g.sendcorex.com/v1/logs' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
{ "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
]
}' Sie erhalten ein Ergebnis pro Befehl, jedes mit seinen logs und einem next_cursor für die nächste Seite. Derselbe Request in 8 Sprachen steht in List Logs.
Häufige Aufgaben
Bounces aus Ihrer Liste entfernen
Fragen Sie alle paar Sekunden bounced-Logs ab, mit after auf dem zuletzt gesehenen, und entfernen Sie diese Adressen auf Ihrer Seite.
Neue Bounces beobachten„Ist meine E-Mail angekommen?“ beantworten
Suchen Sie einen Kunden nach Empfänger und zeigen Sie Status und Serverantwort seiner letzten E-Mails an.
List LogsEinen Versand prüfen
Speichern Sie die ID, die Sie beim Senden erhalten, und lesen Sie das Log später mit Get Logs.
Get LogsSehen, was zugestellt wurde
Get Logs mit include_content liefert das HTML, für Support-Ansichten oder Audits.
Den Body lesenVollständige Referenz
Alles mit CMD ist ein Befehl, der über POST /v1/logs gesendet wird, bis zu 20 pro Request.