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.

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

Nã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. 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. 2

    Recebe 403

    A resposta é 403 Forbidden com o código SPAM_DETECTED, um detectionId e um quarantine_id.

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

  • errorstring

    Mensagem legível explicando que o conteúdo foi marcado como spam.

    ex. "Email content flagged as spam."

  • codestring

    Código de erro para máquinas. Sempre SPAM_DETECTED para emails marcados.

    ex. "SPAM_DETECTED"

  • detectionIdstring

    ID único da detecção de spam. Inclua-o ao falar com o suporte.

    ex. "det_8c1e5a92b7d04f36"

  • quarantine_idstring | null

    ID ú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 | null

    Uma 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 | null

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

  • 401MISSING_AUTH_HEADER

    Nenhum header Authorization presente.

  • 401INVALID_API_KEY

    A API key é inválida ou foi revogada.

  • 401ACCOUNT_BLOCKED

    A conta foi bloqueada.

  • 401NO_CREDITS_LEFT

    Créditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.

  • 401USER_NOT_FOUND

    Usuário não encontrado.

  • 401MISSING_USER_PRIVILEGES

    Faltam privilégios de usuário.

  • 401EMAIL_CREDITS_NOT_FOUND

    Erro ao buscar os créditos de email.

  • 401EMAIL_NOT_VALIDATED

    O email da conta ainda não foi verificado.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key bloqueada temporariamente por violações repetidas da política.

  • 429IP_TEMPORARILY_BLOCKED

    IP da requisição bloqueado temporariamente por violações repetidas da política.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Requisições simultâneas demais deste IP. Tente de novo em instantes.

  • 400MISSING_QUARANTINE_ID

    quarantine_id é obrigatório.

  • 403RELEASE_LIMIT_REACHED

    Liberações de quarentena demais (limite: 10 / 3h). Conta em análise.

  • 403QUARANTINE_FORBIDDEN

    O registro de quarentena pertence a outra conta.

  • 404QUARANTINE_NOT_FOUND

    Registro de quarentena não encontrado ou já processado.

  • 410QUARANTINE_EXPIRED

    O registro de quarentena expirou. Reenvie o email.

  • 409QUARANTINE_ALREADY_APPROVED

    Este email já foi aprovado pela nossa equipe e está sendo entregue. Nenhuma ação necessária.

  • 409QUARANTINE_IN_PROGRESS

    Este email já está sendo liberado (outra requisição chegou primeiro). Nenhuma ação necessária.

  • 500INTERNAL_SERVER_ERROR

    Erro inesperado no servidor. Tente de novo.

  • 500QUARANTINE_CORRUPT

    Payload de quarentena corrompido.

  • 503AUTH_UNAVAILABLE

    Não foi possível validar a API key agora. Tente de novo.