Recevoir des e-mails : Identité

Whoami

Renvoie la boîte mail à laquelle appartient cet identifiant et des détails sur l'identifiant lui-même, sans lire aucun message. Utilisez-le pour vérifier qu'un identifiant appartient à une boîte précise.

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

Tous les champs de token, sauf type, ne sont renvoyés que si l'identifiant est un jeton de boîte (mailbox_token). Les jetons d'accès OAuth ne renvoient que token.type.

Arguments

Cet endpoint n'accepte aucun argument.

Démarrage rapide

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);

Réponse

{
  "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"
        }
      }
    }
  ]
}

Champs de la réponse

  • mailbox.email

    L'adresse de la boîte à laquelle appartient cet identifiant.

  • mailbox.from_name

    Le nom affiché lors de l'envoi depuis cette boîte.

  • mailbox.sender_ref

    La référence du profil d'expéditeur de cette boîte.

  • token.type

    mailbox_token pour un jeton de boîte, oauth pour un jeton d'accès OAuth.

  • token.id

    L'ID du jeton. Uniquement pour mailbox_token.

  • token.name

    Le nom donné au jeton. Uniquement pour mailbox_token.

  • token.prefix

    Les premiers caractères du jeton, tels qu'affichés dans le tableau de bord. Uniquement pour mailbox_token.

  • token.created_at

    Date de création du jeton. Uniquement pour mailbox_token.

  • token.expires_at

    Date d'expiration du jeton, ou null s'il n'expire jamais. Uniquement pour mailbox_token.

  • token.last_used_at

    La dernière utilisation du jeton, ou null. Uniquement pour mailbox_token.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.