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.

POSThttps://g.sendcorex.com/v1command: list_messages

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

    Nach Lesestatus filtern. Dieser Filter durchsucht den Ordner.

  • is_starredbooleanoptional

    Nach Stern filtern. Dieser Filter durchsucht den Ordner.

  • is_importantbooleanoptional

    Nach Wichtigkeit filtern. Dieser Filter durchsucht den Ordner.

  • is_spambooleanoptional

    Nach Spam filtern. Dieser Filter durchsucht den Ordner.

  • afterstringoptional

    Nur Nachrichten, die an oder nach diesem Datum empfangen wurden. RFC 3339, YYYY-MM-DD (UTC) oder Epoch in Millisekunden.

  • beforestringoptional

    Nur Nachrichten, die vor diesem Datum empfangen wurden. Gleiche Formate wie after.

  • labelstringoptional

    Listet die Nachrichten mit diesem Label in allen Ordnern auf. folder und die booleschen Filter werden ignoriert. Groß-/Kleinschreibung egal. after und before funktionieren 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_uid

    Die ID der Nachricht.

  • messages[].thread_id

    Die Konversation, zu der die Nachricht gehört.

  • messages[].folder

    Der Ordner dieses Eintrags.

  • messages[].subject / preview

    Betreff und kurze Vorschau.

  • messages[].from_name / from_email

    Der Absender.

  • messages[].has_attachments / size_bytes

    Anhang-Flag und Nachrichtengröße.

  • messages[].is_read / is_starred / is_important / is_spam

    Status der Nachricht.

  • messages[].snoozed_until

    Wann eine zurückgestellte Nachricht fällig ist, oder null.

  • messages[].received_at

    Wann die Nachricht empfangen wurde.

  • has_more / next_cursor

    Paginierung.

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.

  • 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.