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.
https://mail.sendcorex.com/v3.0/quarantine/releaseDe 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órioO ID retornado na resposta 403 de /send quando o email foi marcado.
ex.
"qtn_3f2a1b4c8e9d4f7a"
O que acontece na liberação
- 1
Consulta
O registro de quarentena é buscado e validado contra a sua conta. Registros de outras contas são rejeitados.
- 2
Sanitização
O corpo e o assunto são sanitizados para remover qualquer padrão nocivo restante antes da entrega.
- 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
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.
- 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.