Quarentena
Email marcado como spam
Quando um email enviado é marcado como possível spam, a API retorna 403 em vez de enfileirar a mensagem. Um quarantine_id é retornado para você revisar e liberar o email depois.
https://mail.sendcorex.com/v3.0/sendNão entregue: um email em quarentena não é enviado. Use /quarantine/release para entregá-lo após a revisão. O registro expira após 3 horas.
Como funciona
- 1
Envio
Você chama /send normalmente. Se o corpo ou o assunto acionar o filtro de spam, a API guarda o payload bruto em quarentena em vez de enfileirar o email.
- 2
Recebe 403
A resposta é 403 Forbidden com o código SPAM_DETECTED, um detectionId e um quarantine_id.
- 3
Revisão
Analise o conteúdo marcado. Se o email for legítimo, chame /quarantine/release com o quarantine_id em até 3 horas. O corpo e o assunto são sanitizados antes da entrega.
Payload do 403
errorstringMensagem legível explicando que o conteúdo foi marcado como spam.
ex.
"Email content flagged as spam."codestringCódigo de erro para máquinas. Sempre SPAM_DETECTED para emails marcados.
ex.
"SPAM_DETECTED"detectionIdstringID único da detecção de spam. Inclua-o ao falar com o suporte.
ex.
"det_8c1e5a92b7d04f36"quarantine_idstring | nullID único da mensagem em quarentena. Passe-o para /quarantine/release para entregar o email. É null quando a mensagem não pôde ser armazenada para liberação.
ex.
"qtn_3f2a1b4c8e9d4f7a"release_instructionsstring | nullUma dica curta de como liberar o email. null quando não há quarantine_id.
ex.
"POST /v3.0/quarantine/release with { quarantine_id }"expires_instring | nullPor quanto tempo o registro de quarentena fica disponível para liberação.
ex.
"3 hours"
Início 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;
}
}Resposta
{
"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"
}Os erros retornam um objeto JSON com error e code.
- 401
MISSING_AUTH_HEADERNenhum header Authorization presente.
- 401
INVALID_API_KEYA API key é inválida ou foi revogada.
- 401
ACCOUNT_BLOCKEDA conta foi bloqueada.
- 401
NO_CREDITS_LEFTCréditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.
- 401
USER_NOT_FOUNDUsuário não encontrado.
- 401
MISSING_USER_PRIVILEGESFaltam privilégios de usuário.
- 401
EMAIL_CREDITS_NOT_FOUNDErro ao buscar os créditos de email.
- 401
EMAIL_NOT_VALIDATEDO email da conta ainda não foi verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporariamente por violações repetidas da política.
- 429
IP_TEMPORARILY_BLOCKEDIP da requisição bloqueado temporariamente por violações repetidas da política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSRequisições simultâneas demais deste IP. Tente de novo em instantes.
- 400
MISSING_QUARANTINE_IDquarantine_id é obrigatório.
- 403
RELEASE_LIMIT_REACHEDLiberações de quarentena demais (limite: 10 / 3h). Conta em análise.
- 403
QUARANTINE_FORBIDDENO registro de quarentena pertence a outra conta.
- 404
QUARANTINE_NOT_FOUNDRegistro de quarentena não encontrado ou já processado.
- 410
QUARANTINE_EXPIREDO registro de quarentena expirou. Reenvie o email.
- 409
QUARANTINE_ALREADY_APPROVEDEste email já foi aprovado pela nossa equipe e está sendo entregue. Nenhuma ação necessária.
- 409
QUARANTINE_IN_PROGRESSEste email já está sendo liberado (outra requisição chegou primeiro). Nenhuma ação necessária.
- 500
INTERNAL_SERVER_ERRORErro inesperado no servidor. Tente de novo.
- 500
QUARANTINE_CORRUPTPayload de quarentena corrompido.
- 503
AUTH_UNAVAILABLENão foi possível validar a API key agora. Tente de novo.