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.
https://g.sendcorex.com/v1command: whoamiTous 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.emailL'adresse de la boîte à laquelle appartient cet identifiant.
mailbox.from_nameLe nom affiché lors de l'envoi depuis cette boîte.
mailbox.sender_refLa référence du profil d'expéditeur de cette boîte.
token.typemailbox_tokenpour un jeton de boîte,oauthpour un jeton d'accès OAuth.token.idL'ID du jeton. Uniquement pour
mailbox_token.token.nameLe nom donné au jeton. Uniquement pour
mailbox_token.token.prefixLes premiers caractères du jeton, tels qu'affichés dans le tableau de bord. Uniquement pour
mailbox_token.token.created_atDate de création du jeton. Uniquement pour
mailbox_token.token.expires_atDate d'expiration du jeton, ou
nulls'il n'expire jamais. Uniquement pourmailbox_token.token.last_used_atLa dernière utilisation du jeton, ou
null. Uniquement pourmailbox_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.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus 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.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.