Quarantaine

Libérer un e-mail

Libère un e-mail en quarantaine pour livraison. Le corps et l'objet sont nettoyés avant l'envoi. Chaque quarantine_id ne peut être libéré qu'une seule fois.

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

D'où vient l'ID ? Quand /send signale un message, il renvoie 403 avec un quarantine_id. ConsultezMes messages sont signalés comme spam.

!

Limites :un enregistrement de quarantaine expire au bout de 3 heures, et les libérations sont plafonnées à 10 toutes les 3 heures. Dépasser ce plafond renvoie RELEASE_LIMIT_REACHED et le compte est placé en examen. Vérifiez le contenu avant de libérer.

Paramètres du body

  • quarantine_idstringobligatoire

    L'ID renvoyé dans la réponse 403 de /send lorsque l'e-mail a été signalé.

    ex. "qtn_3f2a1b4c8e9d4f7a"

Ce qui se passe lors de la libération

  1. 1

    Recherche

    L'enregistrement de quarantaine est récupéré et validé par rapport à votre compte. Les enregistrements appartenant à d'autres comptes sont rejetés.

  2. 2

    Nettoyage

    Le corps et l'objet sont nettoyés pour supprimer tout motif dangereux restant avant la livraison.

  3. 3

    Ingestion

    Chaque destinataire du payload d'origine reçoit un enregistrement d'e-mail individuel, préparé et envoyé via le pipeline d'ingestion interne.

  4. 4

    Marquage comme libéré

    L'enregistrement de quarantaine est marqué released: true et le compteur de libérations est incrémenté. Les appels suivants avec le même ID sont rejetés.

Comme le corps et l'objet sont nettoyés, l'e-mail livré peut différer de celui que vous avez envoyé à l'origine.

Démarrage rapide

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)`);

Réponse

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

Les erreurs renvoient un objet JSON avec error, code et responseTime.

  • 401MISSING_AUTH_HEADER

    Aucun en-tête Authorization n'est présent.

  • 401INVALID_API_KEY

    La clé API est invalide ou révoquée.

  • 401ACCOUNT_BLOCKED

    Le compte a été bloqué.

  • 401NO_CREDITS_LEFT

    Crédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.

  • 401USER_NOT_FOUND

    Utilisateur introuvable.

  • 401MISSING_USER_PRIVILEGES

    Privilèges utilisateur manquants.

  • 401EMAIL_CREDITS_NOT_FOUND

    Erreur lors de la récupération des crédits e-mail.

  • 401EMAIL_NOT_VALIDATED

    L'adresse e-mail du compte n'a pas encore été vérifiée.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    Clé API temporairement bloquée après des violations répétées de la politique.

  • 429IP_TEMPORARILY_BLOCKED

    IP de la requête temporairement bloquée après des violations répétées de la politique.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Trop de requêtes simultanées depuis cette IP. Réessayez dans un instant.

  • 400MISSING_QUARANTINE_ID

    quarantine_id est obligatoire.

  • 403RELEASE_LIMIT_REACHED

    Trop de libérations de quarantaine (limite : 10 / 3h). Compte en cours de vérification.

  • 403QUARANTINE_FORBIDDEN

    L'enregistrement de quarantaine appartient à un autre compte.

  • 404QUARANTINE_NOT_FOUND

    Enregistrement de quarantaine introuvable ou déjà traité.

  • 410QUARANTINE_EXPIRED

    L'enregistrement de quarantaine a expiré. Renvoyez l'e-mail.

  • 409QUARANTINE_ALREADY_APPROVED

    Cet e-mail a déjà été approuvé par notre équipe et est en cours de livraison. Aucune action requise.

  • 409QUARANTINE_IN_PROGRESS

    Cet e-mail est déjà en cours de libération (une autre requête est arrivée avant). Aucune action requise.

  • 500INTERNAL_SERVER_ERROR

    Erreur serveur inattendue. Réessayez.

  • 500QUARANTINE_CORRUPT

    Payload de quarantaine corrompu.

  • 503AUTH_UNAVAILABLE

    Impossible de valider la clé API pour le moment. Réessayez.