Cuarentena

Liberar email

Libera un email en cuarentena para su entrega. El cuerpo y el asunto se sanean antes del envío. Cada quarantine_id solo se puede liberar una vez.

POSThttps://mail.sendcorex.com/v3.0/quarantine/release
i

¿De dónde sale el ID? Cuando /send marca un mensaje, devuelve 403 con un quarantine_id. ConsultaMis mensajes se marcan como spam.

!

Límites:un registro de cuarentena expira a las 3 horas y las liberaciones están limitadas a 10 cada 3 horas. Superar el límite devuelve RELEASE_LIMIT_REACHED y la cuenta pasa a revisión. Revisa el contenido antes de liberar.

Parámetros del body

  • quarantine_idstringobligatorio

    El ID devuelto en la respuesta 403 de /send cuando el email se marcó.

    p. ej. "qtn_3f2a1b4c8e9d4f7a"

Qué pasa al liberar

  1. 1

    Búsqueda

    El registro de cuarentena se obtiene y se valida contra tu cuenta. Los registros de otras cuentas se rechazan.

  2. 2

    Saneamiento

    El cuerpo y el asunto se sanean para eliminar cualquier patrón dañino restante antes de la entrega.

  3. 3

    Ingesta

    Cada destinatario del payload original recibe un registro de email individual, preparado y despachado mediante el pipeline interno de ingesta.

  4. 4

    Marcar como liberado

    El registro de cuarentena se marca como released: true y se incrementa el contador de liberaciones. Las llamadas posteriores con el mismo ID se rechazan.

Como el cuerpo y el asunto se sanean, el email entregado puede ser diferente del que enviaste originalmente.

Inicio rápido

import axios from 'axios';

const quarantineId = 'qtn_3f2a1b4c8e9d4f7a';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/quarantine/release',
  { quarantine_id: quarantineId },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

const { success, released, recipients } = response.data;
console.log(`Released to ${recipients} recipient(s)`);

Respuesta

{
  "success": true,
  "released": true,
  "code": "QUARANTINE_RELEASED",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "recipients": 1
}

Los errores devuelven un objeto JSON con error, code y responseTime.

  • 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.