E-Mails empfangen: Lesen
Threads auflisten
Listen Sie die Konversationen eines Ordners im Gmail-Stil auf, mit Filtern für ungelesen, markiert, wichtig, Anhänge und Datum.
https://g.sendcorex.com/v1command: list_threadsJedes Element ist eine Konversation. Öffnen Sie sie mit get_thread oder get_messages über ihre last_message_uid.
Argumente
folderstringoptionalAufzulistender Ordner. Standard ist
INBOX.limitnumberoptionalSeitengröße, 1 bis 100. Standard ist 25.
cursorstringoptionalDer
next_cursorder vorherigen Seite.is_readbooleanoptionalfalseliefert nur Konversationen mit einer ungelesenen Nachricht.is_starredbooleanoptionalNach Stern filtern.
is_importantbooleanoptionalNach Wichtigkeit filtern.
has_attachmentsbooleanoptionalNach Anhängen filtern.
afterstringoptionalNur Konversationen, deren letzte Nachricht an oder nach diesem Datum liegt (inklusive). RFC 3339,
YYYY-MM-DD(UTC) oder Epoch in Millisekunden.z. B.
"2026-10-01"beforestringoptionalNur Konversationen, deren letzte Nachricht vor diesem Datum liegt (exklusive). Gleiche Formate wie
after.z. B.
"2026-10-08T00:00:00+08:00"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_threads",
args: {
folder: "INBOX",
is_read: false,
limit: 20
}
}
]
},
{ 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_threads",
"id": "0",
"type": "SUCCESS",
"data": {
"threads": [
{
"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",
"participants": [
"ana@client.com",
"you@yourdomain.com"
],
"last_senders": [
"ana@client.com"
],
"message_count": 2,
"thread_message_count": 3,
"unread_count": 1,
"has_unread": true,
"has_starred": false,
"has_important": false,
"has_attachments": false,
"last_message_uid": "Vj0xQUJDMTIz",
"last_message_at": "2026-10-09T14:21:07Z"
}
],
"has_more": true,
"next_cursor": "eyJwIjoyfQ"
}
}
]
}Antwortfelder
threads[].thread_idDie ID der Konversation.
threads[].folderDer aufgelistete Ordner.
threads[].subjectBetreff der Konversation.
threads[].previewKurze Vorschau der neuesten Nachricht.
threads[].from_name / from_emailAbsender der neuesten Nachricht.
threads[].participantsAlle Beteiligten der Konversation.
threads[].last_sendersWer die neuesten Nachrichten geschrieben hat.
threads[].message_countNachrichten in diesem Ordner.
threads[].thread_message_countNachrichten in der gesamten Konversation.
threads[].unread_count / has_unreadUngelesene Nachrichten in der Konversation.
threads[].has_starred / has_important / has_attachmentsFlags der Konversation.
threads[].last_message_uidDie ID, mit der Sie die Konversation über
get_messagesoderget_threadöffnen.threads[].last_message_atDatum der neuesten Nachricht.
has_more / next_cursorPaginierung. Senden Sie
next_cursoralscursor, um die nächste Seite zu erhalten.
Filter und Geschwindigkeit
is_read: false, is_starred: true und is_important: true nutzen einen eigenen Index, daher werden nur passende Konversationen untersucht, nicht der ganze Ordner. Kombinieren Sie sie, wird ein Index verwendet (Stern, dann wichtig, dann ungelesen) und der Rest darauf gefiltert. after und before sind Schlüsselbereiche, daher wird nichts außerhalb des Zeitraums durchsucht. has_attachments und die false-Werte von Stern und wichtig durchsuchen weiterhin den Ordner.
Ungelesene Konversationen in einem Zeitraum
{
"commands": [
{
"command": "list_threads",
"args": {
"is_read": false,
"after": "2026-10-01",
"before": "2026-10-08T00:00:00+08:00"
}
}
]
}Paginierung
Wenn has_more den Wert true hat, rufen Sie den Befehl erneut mit cursor gleich next_cursor auf.
Node.js
let cursor;
const threads = [];
do {
const [result] = await call({
command: 'list_threads',
args: { folder: 'INBOX', limit: 100, ...(cursor ? { cursor } : {}) },
});
threads.push(...result.data.threads);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call ist ein beliebiger Helper, der { commands: [...] } per POST an /v1 sendet und results zurückgibt, wie bei Run Commands.
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.