Cuarentena

Email marcado como spam

Cuando un email enviado se marca como posible spam, la API devuelve 403 en lugar de encolar el mensaje. Se devuelve un quarantine_id para que puedas revisar y liberar el email más tarde.

POSThttps://mail.sendcorex.com/v3.0/send
!

No entregado: un email en cuarentena no se envía. Usa /quarantine/release para entregarlo después de revisarlo. El registro expira a las 3 horas.

Cómo funciona

  1. 1

    Envío

    Llamas a /send normalmente. Si el cuerpo o el asunto activan el filtro de spam, la API guarda el payload original en cuarentena en lugar de encolar el email.

  2. 2

    Recibes 403

    La respuesta es 403 Forbidden con el código SPAM_DETECTED, un detectionId y un quarantine_id.

  3. 3

    Revisión

    Revisa el contenido marcado. Si el email es legítimo, llama a /quarantine/release con el quarantine_id antes de 3 horas. El cuerpo y el asunto se sanean antes de la entrega.

Payload del 403

  • errorstring

    Mensaje legible que explica que el contenido se marcó como spam.

    p. ej. "Email content flagged as spam."

  • codestring

    Código de error legible por máquinas. Siempre SPAM_DETECTED para los emails marcados.

    p. ej. "SPAM_DETECTED"

  • detectionIdstring

    ID único de la detección de spam. Inclúyelo al contactar con soporte.

    p. ej. "det_8c1e5a92b7d04f36"

  • quarantine_idstring | null

    ID único del mensaje en cuarentena. Pásalo a /quarantine/release para entregar el email. Es null cuando el mensaje no se pudo guardar para liberarlo.

    p. ej. "qtn_3f2a1b4c8e9d4f7a"

  • release_instructionsstring | null

    Una pista breve de cómo liberar el email. null cuando no hay quarantine_id.

    p. ej. "POST /v3.0/quarantine/release with { quarantine_id }"

  • expires_instring | null

    Cuánto tiempo permanece disponible el registro de cuarentena para liberarlo.

    p. ej. "3 hours"

Inicio rápido

import axios from 'axios';

try {
  const response = await axios.post(
    'https://mail.sendcorex.com/v3.0/send',
    {
      to: 'user@example.com',
      from: 'noreply@yourdomain.com',
      senderName: 'My App',
      subject: 'Hello!',
      body: '<p>Your message here.</p>',
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );
  console.log('Queued:', response.data.id);
} catch (err) {
  if (err.response?.status === 403 && err.response.data.code === 'SPAM_DETECTED') {
    // Email flagged as spam: save quarantine_id to release it later
    const { quarantine_id, detectionId, expires_in } = err.response.data;
    console.log('Quarantined:', quarantine_id, '| detection:', detectionId, '| expires in', expires_in);
  } else {
    throw err;
  }
}

Respuesta

{
  "error": "Email content flagged as spam.",
  "code": "SPAM_DETECTED",
  "detectionId": "det_8c1e5a92b7d04f36",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "release_instructions": "POST /v3.0/quarantine/release with { quarantine_id }",
  "expires_in": "3 hours"
}

Los errores devuelven un objeto JSON con error y code.

  • 401MISSING_AUTH_HEADER

    No hay header Authorization.

  • 401INVALID_API_KEY

    La API key no es válida o fue revocada.

  • 401ACCOUNT_BLOCKED

    La cuenta fue bloqueada.

  • 401NO_CREDITS_LEFT

    No hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.

  • 401USER_NOT_FOUND

    Usuario no encontrado.

  • 401MISSING_USER_PRIVILEGES

    Faltan privilegios de usuario.

  • 401EMAIL_CREDITS_NOT_FOUND

    Error al obtener los créditos de email.

  • 401EMAIL_NOT_VALIDATED

    El email de la cuenta aún no fue verificado.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key bloqueada temporalmente por violaciones repetidas de la política.

  • 429IP_TEMPORARILY_BLOCKED

    IP de la solicitud bloqueada temporalmente por violaciones repetidas de la política.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Demasiadas solicitudes simultáneas desde esta IP. Inténtalo de nuevo en breve.

  • 400MISSING_QUARANTINE_ID

    quarantine_id es obligatorio.

  • 403RELEASE_LIMIT_REACHED

    Demasiadas liberaciones de cuarentena (límite: 10 / 3h). Cuenta en revisión.

  • 403QUARANTINE_FORBIDDEN

    El registro de cuarentena pertenece a otra cuenta.

  • 404QUARANTINE_NOT_FOUND

    Registro de cuarentena no encontrado o ya procesado.

  • 410QUARANTINE_EXPIRED

    El registro de cuarentena expiró. Vuelve a enviar el email.

  • 409QUARANTINE_ALREADY_APPROVED

    Este email ya fue aprobado por nuestro equipo y se está entregando. No hace falta hacer nada.

  • 409QUARANTINE_IN_PROGRESS

    Este email ya se está liberando (otra solicitud llegó primero). No hace falta hacer nada.

  • 500INTERNAL_SERVER_ERROR

    Error inesperado del servidor. Inténtalo de nuevo.

  • 500QUARANTINE_CORRUPT

    Payload de cuarentena dañado.

  • 503AUTH_UNAVAILABLE

    No se pudo validar la API key en este momento. Inténtalo de nuevo.