Logs: Lesen
Logs abrufen
Lesen Sie bis zu 50 Logs per E-Mail-ID, der `id`, die Sie beim Senden erhalten. Fügen Sie `include_content` hinzu, um das zugestellte HTML zu erhalten.
https://g.sendcorex.com/v1/logscommand: get_logsErfordert den Scope logs:read für Ihren API key.
Eine ID nachzuschlagen kostet gleich viel, egal wie viele E-Mails Sie senden: Dahinter steckt kein Scan.
Argumente
idsstring[]optionalBis zu 50 E-Mail-IDs (UUIDs). Doppelte IDs zählen einmal.
z. B.
["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]idstringoptionalEine einzelne E-Mail-ID. Verwenden Sie dies oder
ids.z. B.
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"include_contentbooleanoptionalLiefert zusätzlich das HTML jeder E-Mail. Damit liegt das Limit bei 10 IDs pro Befehl.
z. B.
true
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "get_logs",
args: {
ids: [
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"00000000-0000-4000-8000-000000000000"
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "get_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"logs": [
{
"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"
}
],
"not_found": [
"00000000-0000-4000-8000-000000000000"
]
}
}
]
}Antwortfelder
logsDie gefundenen Logs, in der angefragten Reihenfolge.
not_foundDie IDs, die in Ihrem Konto nicht existieren, älter als 60 Tage sind oder zu Warm-up-E-Mails gehören.
logs[].idDie E-Mail-ID (eine UUID). Es ist die
id, die Sie beim Senden erhalten, und die Sie an Get Logs übergeben.logs[].to / logs[].domainDer Empfänger und die Domain des Empfängers.
logs[].from_domainDie Domain des Absenders (der Teil nach dem @ in
from).logs[].fromDie Absenderadresse.
logs[].subjectDie Betreffzeile.
logs[].statusdelivered,bounced,spam,rate_limitedodernot_sent.status_codeist dasselbe als Zahl.logs[].responseWas der Empfängerserver geantwortet hat, zum Beispiel
250 2.0.0 OKoder der550-Bounce-Grund.logs[].messageZusätzliche Details von Sendcorex zur Zustellung, falls vorhanden.
logs[].blocked / logs[].block_reasontrue, wenn Sendcorex nicht an diesen Empfänger gesendet hat (unterdrückt oder eingeschränkt), und der Grund.logs[].retriesWie oft die Zustellung erneut versucht wurde.
logs[].tracking_idDie interne Zustell-ID. Bounce- und Beschwerde-Webhooks tragen denselben Wert.
logs[].sent_at / logs[].updated_atWann die E-Mail gesendet wurde und wann sich ihr Status zuletzt geändert hat. ISO 8601, UTC.
logs[].content.htmlDas zugestellte HTML. Nur mit
include_content: true;null, wenn der Body nicht gespeichert wurde.
Den Body lesen
Der Body ist der schwerste Teil eines Logs, daher kommt er nur auf Anfrage zurück. Es ist das HTML, wie es zugestellt wurde: War Tracking aktiv, kann es das Tracking-Pixel und umgeschriebene Links enthalten.
Request-Body
{
"commands": [
{
"command": "get_logs",
"args": {
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"include_content": true
}
}
]
}Das Rendern dieses HTML kann das Tracking-Pixel laden und als Öffnung zählen. Zeigen Sie es in einem Sandbox-iframe mit blockierten externen Bildern an, so wie das Dashboard.
Details zu einer Seite von List Logs
Verketten Sie die beiden Befehle mit $ref: Die IDs aus der Liste gehen direkt an Get Logs, in einem einzigen Request.
Request-Body
{
"commands": [
{
"command": "list_logs",
"id": "bounces",
"args": {
"status": "bounced",
"limit": 10
}
},
{
"command": "get_logs",
"args": {
"ids": {
"$ref": "bounces",
"path": "logs/*/id"
},
"include_content": true
}
}
]
}Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat `logs:read` nicht.
- CMD
INVALID_ARGSEin Argument ist ungültig: unbekannter Status, Empfänger ohne vollständige E-Mail-Adresse, limit außerhalb des Bereichs, ID, die keine UUID ist, after später als before…
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.