Quarentena

Liberar email

Libera um email em quarentena para entrega. O corpo e o assunto são sanitizados antes do envio. Cada quarantine_id só pode ser liberado uma vez.

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

De onde vem o ID? Quando /send marca uma mensagem, ele retorna 403 com um quarantine_id. VejaMinhas mensagens são marcadas como spam.

!

Limites:um registro de quarentena expira após 3 horas, e as liberações são limitadas a 10 a cada 3 horas. Passar do limite retorna RELEASE_LIMIT_REACHED e a conta entra em análise. Revise o conteúdo antes de liberar.

Parâmetros do body

  • quarantine_idstringobrigatório

    O ID retornado na resposta 403 de /send quando o email foi marcado.

    ex. "qtn_3f2a1b4c8e9d4f7a"

O que acontece na liberação

  1. 1

    Consulta

    O registro de quarentena é buscado e validado contra a sua conta. Registros de outras contas são rejeitados.

  2. 2

    Sanitização

    O corpo e o assunto são sanitizados para remover qualquer padrão nocivo restante antes da entrega.

  3. 3

    Ingestão

    Cada destinatário do payload original recebe um registro de email individual, preparado e despachado pelo pipeline interno de ingestão.

  4. 4

    Marcar como liberado

    O registro de quarentena é marcado como released: true e o contador de liberações é incrementado. Chamadas seguintes com o mesmo ID são rejeitadas.

Como o corpo e o assunto são sanitizados, o email entregue pode ser diferente do que você enviou originalmente.

Início 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)`);

Resposta

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

Os erros retornam um objeto JSON com error, code e responseTime.

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