E-Mails empfangen: Identität

Whoami

Gibt zurück, zu welchem Postfach diese Zugangsdaten gehören, und Details zu den Zugangsdaten selbst, ohne eine Nachricht zu lesen. Nutzen Sie es, um zu prüfen, ob Zugangsdaten zu einem bestimmten Postfach gehören.

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

Alle Felder unter token außer type werden nur zurückgegeben, wenn die Zugangsdaten ein Postfach-Token (mailbox_token) sind. OAuth-Zugriffstoken liefern nur token.type.

Argumente

Dieser Endpoint hat keine Argumente.

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "whoami"
      }
    ]
  },
  { 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": "whoami",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "mailbox": {
          "email": "support@acme.com",
          "from_name": "Acme Support",
          "sender_ref": "snd_7Kq2Xr9P"
        },
        "token": {
          "type": "mailbox_token",
          "id": "mbt_3Fh8LwQ1",
          "name": "Helpdesk bot",
          "prefix": "scx_mb_4f9a",
          "created_at": "2026-10-02T09:14:00.000Z",
          "expires_at": null,
          "last_used_at": "2026-11-19T00:31:12.000Z"
        }
      }
    }
  ]
}

Antwortfelder

  • mailbox.email

    Die Adresse des Postfachs, zu dem diese Zugangsdaten gehören.

  • mailbox.from_name

    Der Anzeigename beim Senden aus diesem Postfach.

  • mailbox.sender_ref

    Die Referenz des Absenderprofils hinter diesem Postfach.

  • token.type

    mailbox_token für ein Postfach-Token, oauth für ein OAuth-Zugriffstoken.

  • token.id

    Die Token-ID. Nur bei mailbox_token.

  • token.name

    Der Name des Tokens. Nur bei mailbox_token.

  • token.prefix

    Die ersten Zeichen des Tokens, wie im Dashboard angezeigt. Nur bei mailbox_token.

  • token.created_at

    Wann das Token erstellt wurde. Nur bei mailbox_token.

  • token.expires_at

    Wann das Token abläuft, oder null, wenn es nie abläuft. Nur bei mailbox_token.

  • token.last_used_at

    Wann das Token zuletzt genutzt wurde, oder null. Nur bei mailbox_token.

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.