Bounces & Complaints: Routen
Run Commands
Der einzige Einstiegspunkt für Bounces und Beschwerden. Senden Sie 1 bis 20 Befehle in einem Request und erhalten Sie ein Ergebnis pro Befehl.
https://g.sendcorex.com/v1/feedbackDerselbe Umschlag wie bei Logs und Contacts: Jeder Lesezugriff ist ein Befehl, der an diese Route gesendet wird. Die Seiten darunter dokumentieren jeden Befehl.
Fehler werden pro Befehl gemeldet. Ein fehlgeschlagener Befehl stoppt die anderen nicht, und der HTTP-Status bleibt 200.
Body-Parameter
commandsobject[]erforderlich1 bis 20 Befehle, der Reihe nach ausgeführt. Der gesamte Body darf bis zu 1 MB groß sein.
commands[].commandstringerforderlichlist_feedbackoderget_email.commands[].argsobjectoptionalDie Argumente des Befehls. Jeder Wert kann ein
$refauf das Ergebnis eines früheren Befehls sein.commands[].idstringoptionalIhr eigener Bezeichner für das Ergebnis. Standard ist der Index (
"0","1"…). Erforderlich, wenn Sie$refverwenden möchten.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "list_feedback",
id: "new",
args: {
cursor: "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
limit: 100
}
},
{
command: "get_email",
id: "one",
args: {
email_id: "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "list_feedback",
"id": "new",
"type": "SUCCESS",
"took_ms": 12,
"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"
},
{
"email_id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"kind": "complaint",
"source": "fbl_microsoft",
"recipient": "ana@outlook.com",
"from": "news@yourdomain.com",
"campaign_id": "c1d2e3f4-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
"reporting_mta": "staff@hotmail.com",
"at": "2026-10-17T09:12:03.500Z"
}
],
"next_cursor": "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
"has_more": false
}
},
{
"command": "get_email",
"id": "one",
"type": "SUCCESS",
"took_ms": 4,
"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
typeImmer
SUCCESS, wenn der Request selbst angenommen wurde.results[].commandDer Befehl, der dieses Ergebnis erzeugt hat.
results[].idDie
id, die Sie gesendet haben, oder der Index des Befehls.results[].typeSUCCESSoderERROR.results[].took_msZeit, die der Befehl im Server gebraucht hat.
results[].dataDie Ausgabe des Befehls. Nur vorhanden, wenn
typeSUCCESSist.results[].code / messageDer Fehler. Nur vorhanden, wenn
typeERRORist.
Authentifizierung
Verwenden Sie den API key, den Sie im Dashboard unter Developers → API Keys erstellen, mit dem Scope feedback:read.
AuthorizationSenden Sie
Authorization: <api key>oderAuthorization: Bearer <api key>.feedback:readDer einzige Scope, den diese Route braucht. Er ist nur lesend.
Mailbox-TokensDer Webmail-Token funktioniert hier nicht. Er wird mit
WRONG_CREDENTIAL_TYPEabgelehnt.Erlaubte IPsHat der Key eine IP-Allowlist, erhalten Requests von anderen IPs
403 IP_NOT_ALLOWED.
Was im Feed steht
Nur, was nicht ankamHard und Soft Bounces, Blockierungen, Spam-Beschwerden und E-Mails, die wir nie gesendet haben. Zugestellte E-Mails stehen nicht hier, sondern in Logs.
Ein Ereignis pro E-Mail und TypLehnt der Server eine E-Mail ab und trifft später eine Bounce-Nachricht dazu ein, erhalten Sie ein Ereignis, nicht zwei. Ebenso bei einem Feedback-Loop-Bericht plus einer Missbrauchsmeldung.
Nur endgültige ErgebnisseVorübergehende Zurückstellungen und Wiederholungsversuche erscheinen nie. Ein Soft Bounce wird erst geschrieben, wenn wir aufgeben.
90 TageEreignisse werden 90 Tage aufbewahrt.
Kein Warm-upE-Mails aus dem Inbox-Warm-up erscheinen nie.
Rate limits und Cache
Limits gelten pro IP + API key. Wenn Sie darüber liegen, wird der Request mit HTTP 429 und einem Retry-After-Header abgelehnt.
15 Requests / SekundeSpitze von 15. Antworten aus dem Cache zählen ebenfalls.
15 gleichzeitigHöchstens 15 Requests werden gleichzeitig verarbeitet.
Lese-Cache: 1,5 sDerselbe Lesezugriff innerhalb von 1,5 Sekunden liefert dasselbe Ergebnis. Polling alle paar Sekunden ist kein Problem.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 400
INVALID_JSONDer Body ist nicht {"commands":[...]} oder größer als 1 MB.
- 400
INVALID_ARGSDer Request enthält keine Befehle oder mehr als 20.
- 401
MISSING_AUTH_HEADEREs wurde kein Authorization-Header gesendet.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 401
API_KEY_EXPIREDDer API key hat das im Dashboard festgelegte Ablaufdatum überschritten.
- 401
WRONG_CREDENTIAL_TYPEEs wurde ein Mailbox-Token gesendet. Die Feedback API braucht einen API key aus dem Dashboard.
- 403
IP_NOT_ALLOWEDDer Request kam von einer IP, die nicht zu den erlaubten IPs des Keys gehört.
- 403
ACCOUNT_BLOCKEDDas Konto ist gesperrt.
- 403
MISSING_SCOPEDer Key hat `feedback:read` nicht, daher kann kein Befehl ausgeführt werden.
- 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.
- 503
AUTH_UNAVAILABLEDie Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.
- CMD
UNKNOWN_COMMANDDer Befehlsname existiert nicht.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.