Quarantaine
E-mail signalé
Lorsqu'un e-mail envoyé est signalé comme spam potentiel, l'API renvoie 403 au lieu de mettre le message en file. Un quarantine_id est renvoyé pour que vous puissiez vérifier et libérer l'e-mail plus tard.
https://mail.sendcorex.com/v3.0/sendNon livré : un e-mail en quarantaine n'est pas envoyé. Utilisez /quarantine/release pour le livrer après vérification. L'enregistrement expire au bout de 3 heures.
Fonctionnement
- 1
Envoi
Vous appelez /send normalement. Si le corps ou l'objet déclenche le filtre anti-spam, l'API stocke le payload brut en quarantaine au lieu de mettre l'e-mail en file.
- 2
Réception du 403
La réponse est 403 Forbidden avec le code SPAM_DETECTED, un detectionId et un quarantine_id.
- 3
Vérification
Examinez le contenu signalé. Si l'e-mail est légitime, appelez /quarantine/release avec le quarantine_id dans les 3 heures. Le corps et l'objet sont nettoyés avant la livraison.
Payload du 403
errorstringMessage lisible expliquant que le contenu a été signalé comme spam.
ex.
"Email content flagged as spam."codestringCode d'erreur lisible par machine. Toujours SPAM_DETECTED pour les e-mails signalés.
ex.
"SPAM_DETECTED"detectionIdstringID unique de la détection de spam. Indiquez-le lorsque vous contactez le support.
ex.
"det_8c1e5a92b7d04f36"quarantine_idstring | nullID unique du message en quarantaine. Passez-le à /quarantine/release pour livrer l'e-mail. Il vaut null lorsque le message n'a pas pu être stocké pour être libéré.
ex.
"qtn_3f2a1b4c8e9d4f7a"release_instructionsstring | nullUne brève indication sur la façon de libérer l'e-mail. null en l'absence de quarantine_id.
ex.
"POST /v3.0/quarantine/release with { quarantine_id }"expires_instring | nullDurée pendant laquelle l'enregistrement de quarantaine reste disponible pour la libération.
ex.
"3 hours"
Démarrage rapide
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;
}
}Réponse
{
"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"
}Erreurs
Tous les codes d'erreur →Les erreurs renvoient un objet JSON avec error et code.
- 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.