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.

POSThttps://mail.sendcorex.com/v3.0/send
!

Non 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. 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. 2

    Réception du 403

    La réponse est 403 Forbidden avec le code SPAM_DETECTED, un detectionId et un quarantine_id.

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

  • errorstring

    Message lisible expliquant que le contenu a été signalé comme spam.

    ex. "Email content flagged as spam."

  • codestring

    Code d'erreur lisible par machine. Toujours SPAM_DETECTED pour les e-mails signalés.

    ex. "SPAM_DETECTED"

  • detectionIdstring

    ID unique de la détection de spam. Indiquez-le lorsque vous contactez le support.

    ex. "det_8c1e5a92b7d04f36"

  • quarantine_idstring | null

    ID 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 | null

    Une 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 | null

    Duré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"
}

Les erreurs renvoient un objet JSON avec error et code.

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