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.
https://mail.sendcorex.com/v3.0/quarantine/release¿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_idstringobligatorioEl ID devuelto en la respuesta 403 de /send cuando el email se marcó.
p. ej.
"qtn_3f2a1b4c8e9d4f7a"
Qué pasa al liberar
- 1
Búsqueda
El registro de cuarentena se obtiene y se valida contra tu cuenta. Los registros de otras cuentas se rechazan.
- 2
Saneamiento
El cuerpo y el asunto se sanean para eliminar cualquier patrón dañino restante antes de la entrega.
- 3
Ingesta
Cada destinatario del payload original recibe un registro de email individual, preparado y despachado mediante el pipeline interno de ingesta.
- 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
}Errores
Todos los códigos de error →Los errores devuelven un objeto JSON con error, code y responseTime.
- 401
MISSING_AUTH_HEADERNo hay header Authorization.
- 401
INVALID_API_KEYLa API key no es válida o fue revocada.
- 401
ACCOUNT_BLOCKEDLa cuenta fue bloqueada.
- 401
NO_CREDITS_LEFTNo hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.
- 401
USER_NOT_FOUNDUsuario no encontrado.
- 401
MISSING_USER_PRIVILEGESFaltan privilegios de usuario.
- 401
EMAIL_CREDITS_NOT_FOUNDError al obtener los créditos de email.
- 401
EMAIL_NOT_VALIDATEDEl email de la cuenta aún no fue verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporalmente por violaciones repetidas de la política.
- 429
IP_TEMPORARILY_BLOCKEDIP de la solicitud bloqueada temporalmente por violaciones repetidas de la política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSDemasiadas solicitudes simultáneas desde esta IP. Inténtalo de nuevo en breve.
- 400
MISSING_QUARANTINE_IDquarantine_id es obligatorio.
- 403
RELEASE_LIMIT_REACHEDDemasiadas liberaciones de cuarentena (límite: 10 / 3h). Cuenta en revisión.
- 403
QUARANTINE_FORBIDDENEl registro de cuarentena pertenece a otra cuenta.
- 404
QUARANTINE_NOT_FOUNDRegistro de cuarentena no encontrado o ya procesado.
- 410
QUARANTINE_EXPIREDEl registro de cuarentena expiró. Vuelve a enviar el email.
- 409
QUARANTINE_ALREADY_APPROVEDEste email ya fue aprobado por nuestro equipo y se está entregando. No hace falta hacer nada.
- 409
QUARANTINE_IN_PROGRESSEste email ya se está liberando (otra solicitud llegó primero). No hace falta hacer nada.
- 500
INTERNAL_SERVER_ERRORError inesperado del servidor. Inténtalo de nuevo.
- 500
QUARANTINE_CORRUPTPayload de cuarentena dañado.
- 503
AUTH_UNAVAILABLENo se pudo validar la API key en este momento. Inténtalo de nuevo.