Recibir correos: Identidad

Whoami

Devuelve a qué buzón pertenece esta credencial y detalles de la propia credencial, sin leer ningún mensaje. Úsalo para verificar que una credencial pertenece a un buzón concreto.

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

Todos los campos de token, salvo type, solo se devuelven cuando la credencial es un token de buzón (mailbox_token). Los tokens de acceso OAuth devuelven solo token.type.

Argumentos

Este endpoint no recibe argumentos.

Inicio rápido

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

Respuesta

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

Campos de la respuesta

  • mailbox.email

    La dirección del buzón al que pertenece esta credencial.

  • mailbox.from_name

    El nombre que se muestra al enviar desde este buzón.

  • mailbox.sender_ref

    La referencia del perfil de remitente de este buzón.

  • token.type

    mailbox_token para un token de buzón, oauth para un token de acceso OAuth.

  • token.id

    El ID del token. Solo para mailbox_token.

  • token.name

    El nombre que se le dio al token. Solo para mailbox_token.

  • token.prefix

    Los primeros caracteres del token, tal como aparecen en el panel. Solo para mailbox_token.

  • token.created_at

    Cuándo se creó el token. Solo para mailbox_token.

  • token.expires_at

    Cuándo caduca el token, o null si no caduca. Solo para mailbox_token.

  • token.last_used_at

    La última vez que se usó el token, o null. Solo para mailbox_token.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.