E-Mails empfangen: Lesen
Nachrichten auflisten
Listen Sie Nachrichten einzeln auf, ohne sie zu Konversationen zu gruppieren. Sie können auch alle Nachrichten mit einem Label auflisten.
https://g.sendcorex.com/v1command: list_messagesArgumente
folderstringoptionalAufzulistender Ordner. Standard ist
INBOX.limitnumberoptionalSeitengröße, 1 bis 100. Standard ist 25.
cursorstringoptionalDer
next_cursorder vorherigen Seite.is_readbooleanoptionalNach Lesestatus filtern. Dieser Filter durchsucht den Ordner.
is_starredbooleanoptionalNach Stern filtern. Dieser Filter durchsucht den Ordner.
is_importantbooleanoptionalNach Wichtigkeit filtern. Dieser Filter durchsucht den Ordner.
is_spambooleanoptionalNach Spam filtern. Dieser Filter durchsucht den Ordner.
afterstringoptionalNur Nachrichten, die an oder nach diesem Datum empfangen wurden. RFC 3339,
YYYY-MM-DD(UTC) oder Epoch in Millisekunden.beforestringoptionalNur Nachrichten, die vor diesem Datum empfangen wurden. Gleiche Formate wie
after.labelstringoptionalListet die Nachrichten mit diesem Label in allen Ordnern auf.
folderund die booleschen Filter werden ignoriert. Groß-/Kleinschreibung egal.afterundbeforefunktionieren weiterhin.z. B.
"cliente-vip"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_messages",
args: {
folder: "INBOX",
is_read: false,
limit: 50
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
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": "list_messages",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"folder": "INBOX",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"has_attachments": false,
"size_bytes": 4821,
"is_read": false,
"is_starred": false,
"is_important": false,
"is_spam": false,
"snoozed_until": null,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Antwortfelder
messages[].message_uidDie ID der Nachricht.
messages[].thread_idDie Konversation, zu der die Nachricht gehört.
messages[].folderDer Ordner dieses Eintrags.
messages[].subject / previewBetreff und kurze Vorschau.
messages[].from_name / from_emailDer Absender.
messages[].has_attachments / size_bytesAnhang-Flag und Nachrichtengröße.
messages[].is_read / is_starred / is_important / is_spamStatus der Nachricht.
messages[].snoozed_untilWann eine zurückgestellte Nachricht fällig ist, oder
null.messages[].received_atWann die Nachricht empfangen wurde.
has_more / next_cursorPaginierung.
Nach Label auflisten
Mit label liest der Befehl den Label-Index, daher werden nur Nachrichten mit Label untersucht. Jede Nachricht wird mit ihrem aktuellen Status über alle Ordner zurückgegeben, sodass Sie folders und labels statt eines einzelnen folder erhalten.
Antwortdaten mit Label
{
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"labels": [
"cliente-vip"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder gehört zu einem anderen Konto oder Ordner.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.