Bounces & Complaints: Lesen
E-Mail abrufen
Alles, was für eine E-Mail zurückkam: ihr Bounce oder ihre Blockierung, ihre Beschwerde oder warum sie nicht gesendet wurde. Ein Lookup, kein Scan.
https://g.sendcorex.com/v1/feedbackcommand: get_emailErfordert den Scope feedback:read für Ihren API key.
Eine E-Mail hat höchstens ein Ereignis pro Gruppe: einen Bounce (bounce_hard, bounce_soft oder blocked), ein complaint und ein dropped.
Argumente
email_idstringerforderlichDie E-Mail-ID, die
id, die Sie beim Senden erhalten haben.z. B.
"9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "get_email",
args: {
email_id: "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
{ 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_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"events": [
{
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"kind": "bounce_hard",
"source": "smtp",
"recipient": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"smtp_code": 550,
"enhanced_code": "5.1.1",
"diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
"at": "2026-10-17T05:58:44.031Z"
}
]
}
}
]
}Antwortfelder
eventsDie Ereignisse dieser E-Mail. Leer, wenn nichts zurückkam (die E-Mail wurde zugestellt oder ist älter als 90 Tage).
events[].email_idDie E-Mail-ID (eine UUID): die
id, die Sie beim Senden erhalten haben, und dieselbe ID wie in Logs und Webhooks.events[].kindWas passiert ist:
bounce_hard,bounce_soft,blocked,complaintoderdropped. Siehe Typen unten.events[].sourceWoher wir es wissen: die SMTP-Antwort, eine Bounce-Nachricht, ein Feedback Loop, eine Missbrauchsmeldung… Siehe Quellen unten.
events[].recipientDie Adresse, an die die E-Mail gesendet wurde.
events[].fromDie Absenderadresse.
events[].campaign_idDie Kampagne, falls die E-Mail zu einer gehört.
events[].smtp_code / events[].enhanced_codeDer Code, den der Empfängerserver geantwortet hat, zum Beispiel
550und5.1.1. Nur bei Bounces und Blockierungen.events[].diagnosticDie vollständige Antwort des Empfängerservers oder der in einer Missbrauchsmeldung genannte Grund.
events[].reporting_mtaWer es gemeldet hat: der Server, der die Bounce-Nachricht gesendet hat, die Feedback-Loop-Adresse oder
webfür die Meldeseite.events[].atWann es passiert ist. ISO 8601, UTC.
„Warum ist meine E-Mail nicht angekommen?“ beantworten
Lesen Sie das Log und sein Feedback auf einmal: Logs nennt Ihnen den Status, dieser Befehl den Grund und wer es gemeldet hat.
Zwei Requests, dieselbe ID
{
"logs": {
"commands": [
{
"command": "get_logs",
"args": {
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
"feedback": {
"commands": [
{
"command": "get_email",
"args": {
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
}
}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 `feedback:read` nicht.
- CMD
INVALID_ARGSEin Argument ist ungültig: unbekannter Typ, `since` nicht im Format RFC 3339, limit außerhalb des Bereichs, fehlende `email_id`…
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.