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.

POSThttps://g.sendcorex.com/v1command: list_threads
i

Jedes Element ist eine Konversation. Öffnen Sie sie mit get_thread oder get_messages über ihre last_message_uid.

Argumente

  • folderstringoptional

    Aufzulistender Ordner. Standard ist INBOX.

  • limitnumberoptional

    Seitengröße, 1 bis 100. Standard ist 25.

  • cursorstringoptional

    Der next_cursor der vorherigen Seite.

  • is_readbooleanoptional

    false liefert nur Konversationen mit einer ungelesenen Nachricht.

  • is_starredbooleanoptional

    Nach Stern filtern.

  • is_importantbooleanoptional

    Nach Wichtigkeit filtern.

  • has_attachmentsbooleanoptional

    Nach Anhängen filtern.

  • afterstringoptional

    Nur 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"

  • beforestringoptional

    Nur 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_id

    Die ID der Konversation.

  • threads[].folder

    Der aufgelistete Ordner.

  • threads[].subject

    Betreff der Konversation.

  • threads[].preview

    Kurze Vorschau der neuesten Nachricht.

  • threads[].from_name / from_email

    Absender der neuesten Nachricht.

  • threads[].participants

    Alle Beteiligten der Konversation.

  • threads[].last_senders

    Wer die neuesten Nachrichten geschrieben hat.

  • threads[].message_count

    Nachrichten in diesem Ordner.

  • threads[].thread_message_count

    Nachrichten in der gesamten Konversation.

  • threads[].unread_count / has_unread

    Ungelesene Nachrichten in der Konversation.

  • threads[].has_starred / has_important / has_attachments

    Flags der Konversation.

  • threads[].last_message_uid

    Die ID, mit der Sie die Konversation über get_messages oder get_thread öffnen.

  • threads[].last_message_at

    Datum der neuesten Nachricht.

  • has_more / next_cursor

    Paginierung. Senden Sie next_cursor als cursor, 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);
i

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.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINVALID_CURSOR

    Der Cursor ist fehlerhaft oder gehört zu einem anderen Konto oder Ordner.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.