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.
https://mail.sendcorex.com/v3.0/quarantine/releaseD'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_idstringobligatoireL'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
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
Nettoyage
Le corps et l'objet sont nettoyés pour supprimer tout motif dangereux restant avant la livraison.
- 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
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
}Erreurs
Tous les codes d'erreur →Les erreurs renvoient un objet JSON avec error, code et responseTime.
- 401
MISSING_AUTH_HEADERAucun en-tête Authorization n'est présent.
- 401
INVALID_API_KEYLa clé API est invalide ou révoquée.
- 401
ACCOUNT_BLOCKEDLe compte a été bloqué.
- 401
NO_CREDITS_LEFTCrédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.
- 401
USER_NOT_FOUNDUtilisateur introuvable.
- 401
MISSING_USER_PRIVILEGESPrivilèges utilisateur manquants.
- 401
EMAIL_CREDITS_NOT_FOUNDErreur lors de la récupération des crédits e-mail.
- 401
EMAIL_NOT_VALIDATEDL'adresse e-mail du compte n'a pas encore été vérifiée.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDClé API temporairement bloquée après des violations répétées de la politique.
- 429
IP_TEMPORARILY_BLOCKEDIP de la requête temporairement bloquée après des violations répétées de la politique.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSTrop de requêtes simultanées depuis cette IP. Réessayez dans un instant.
- 400
MISSING_QUARANTINE_IDquarantine_id est obligatoire.
- 403
RELEASE_LIMIT_REACHEDTrop de libérations de quarantaine (limite : 10 / 3h). Compte en cours de vérification.
- 403
QUARANTINE_FORBIDDENL'enregistrement de quarantaine appartient à un autre compte.
- 404
QUARANTINE_NOT_FOUNDEnregistrement de quarantaine introuvable ou déjà traité.
- 410
QUARANTINE_EXPIREDL'enregistrement de quarantaine a expiré. Renvoyez l'e-mail.
- 409
QUARANTINE_ALREADY_APPROVEDCet e-mail a déjà été approuvé par notre équipe et est en cours de livraison. Aucune action requise.
- 409
QUARANTINE_IN_PROGRESSCet e-mail est déjà en cours de libération (une autre requête est arrivée avant). Aucune action requise.
- 500
INTERNAL_SERVER_ERRORErreur serveur inattendue. Réessayez.
- 500
QUARANTINE_CORRUPTPayload de quarantaine corrompu.
- 503
AUTH_UNAVAILABLEImpossible de valider la clé API pour le moment. Réessayez.