E-Mails empfangen: Ordner und Zähler

Zähler abrufen

Rufen Sie die Gesamt- und Ungelesen-Zähler des gesamten Postfachs und jedes Ordners ab.

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

Die Summen auf oberster Ebene zählen eindeutige Nachrichten. Die Zahlen in jedem Ordner zählen Listeneinträge, daher zählt eine Antwort, die in Sent und INBOX liegt, in jedem Ordner einmal.

Argumente

Dieser Endpoint hat keine Argumente.

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "get_counters"
      }
    ]
  },
  { 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": "get_counters",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "total": 20,
        "unread": 3,
        "size_bytes": 1048576,
        "folders": {
          "INBOX": {
            "total": 12,
            "unread": 3,
            "size_bytes": 482113
          },
          "Sent": {
            "total": 8,
            "unread": 0,
            "size_bytes": 566463
          }
        }
      }
    }
  ]
}

Antwortfelder

  • total

    Eindeutige Nachrichten im Postfach.

  • unread

    Eindeutige ungelesene Nachrichten im Postfach.

  • size_bytes

    Gesamtgröße des Postfachs.

  • folders.<name>.total

    Einträge in diesem Ordner.

  • folders.<name>.unread

    Ungelesene Einträge in diesem Ordner.

  • folders.<name>.size_bytes

    Größe dieses Ordners.

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.