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.
https://mail.sendcorex.com/v3.0/sendNo 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
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
Recibes 403
La respuesta es 403 Forbidden con el código SPAM_DETECTED, un detectionId y un quarantine_id.
- 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
errorstringMensaje legible que explica que el contenido se marcó como spam.
p. ej.
"Email content flagged as spam."codestringCódigo de error legible por máquinas. Siempre SPAM_DETECTED para los emails marcados.
p. ej.
"SPAM_DETECTED"detectionIdstringID único de la detección de spam. Inclúyelo al contactar con soporte.
p. ej.
"det_8c1e5a92b7d04f36"quarantine_idstring | nullID ú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 | nullUna 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 | nullCuá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"
}Errores
Todos los códigos de error →Los errores devuelven un objeto JSON con error y code.
- 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.