E-Mails empfangen: Ordner und Zähler

Ordner auflisten

Listen Sie die Systemordner und Ihre eigenen Ordner auf, jeweils mit Gesamtzahl und Anzahl ungelesener Einträge.

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

Die Ergebnisse werden 1,5 Sekunden lang gecacht.

Argumente

Dieser Endpoint hat keine Argumente.

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "list_folders"
      }
    ]
  },
  { 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_folders",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "folders": [
          {
            "folder": "INBOX",
            "name": "INBOX",
            "system": true,
            "total": 12,
            "unread": 3
          },
          {
            "folder": "Sent",
            "name": "Sent",
            "system": true,
            "total": 8,
            "unread": 0
          },
          {
            "folder": "projeto-x",
            "name": "Projeto X",
            "system": false,
            "total": 4,
            "unread": 1
          }
        ]
      }
    }
  ]
}

Antwortfelder

  • folders[].folder

    Die Ordnerkennung (Slug). Verwenden Sie sie in anderen Befehlen.

  • folders[].name

    Der Anzeigename.

  • folders[].system

    true für Systemordner, false für eigene Ordner.

  • folders[].total

    Anzahl der Einträge im Ordner.

  • folders[].unread

    Anzahl der ungelesenen Einträge im Ordner.

Systemordner

INBOX, Sent, Archive, Trash, Drafts, Spam, Promotions, Snoozed, Scheduled (E-Mails, die auf den Versand warten), Agents (von KI-Agenten geschrieben) und NotSubscribing (gibt an, nicht kaufen oder abonnieren zu wollen). Aliase wie inbox, archived, draft, junk, promotion und not-subscribing werden überall akzeptiert, wo ein Ordner erwartet wird.

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.

  • CMDINTERNAL

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