E-mail

Envoyer des pièces jointes

Joignez des fichiers à n'importe quel e-mail en incluant le tableau attachments dans le payload d'envoi. Les fichiers doivent être encodés en base64, et vous pouvez inclure plusieurs pièces jointes en un seul appel.

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

Les pièces jointes utilisent le même endpoint que Envoyer un e-mail. Ajoutez le tableau attachments à côté des autres paramètres du body.

Paramètres de pièce jointe

Chaque élément du tableau attachments est un objet contenant les champs ci-dessous.

  • filenamestringobligatoire

    Le nom de fichier affiché au destinataire dans son client de messagerie.

    ex. "invoice.pdf"

  • contentstringobligatoire

    Le contenu du fichier encodé sous forme de string base64.

    ex. "JVBERi0xLjQKJeLjz9MK..."

  • encodingstringobligatoire

    L'encodage de content. Doit être "base64".

    ex. "base64"

Démarrage rapide

import axios from 'axios';
import fs from 'fs';

const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');

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: 'Your Invoice #1042',
      body: '<p>Please find your invoice attached.</p>',
      attachments: [
        {
          filename: 'invoice.pdf',
          content: fileContent,
          encoding: 'base64',
        },
      ],
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );

  const { id, ids, recipients } = response.data;
  console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
  if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
    // Attachment blocked for security reasons. There is no quarantine record.
    console.log('Blocked:', err.response.data.riskLevel);
  } else {
    throw err;
  }
}

Réponse

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null
}

Ma pièce jointe a été bloquée

Pour protéger notre plateforme et la réputation d'envoi de chaque client, les pièces jointes sont vérifiées avant la mise en file d'un e-mail. Lorsqu'un fichier est jugé dangereux, la requête renvoie 400 avec le code DANGEROUS_ATTACHMENT et l'e-mail n'est pas envoyé.

400

Pièce jointe bloquée

{
  "error": "One or more attachments were blocked for security reasons.",
  "code": "DANGEROUS_ATTACHMENT",
  "riskLevel": "high"
}
  • error

    Un message lisible expliquant qu'une pièce jointe a été bloquée.

  • code

    Toujours DANGEROUS_ATTACHMENT pour cette réponse.

  • riskLevel

    Le niveau de risque attribué à la pièce jointe bloquée. Indiquez-le lorsque vous contactez le support.

!

Il n'y a pas d'enregistrement de quarantaine pour cette erreur.Contrairement aux e-mails signalés, une pièce jointe bloquée ne peut pas être libérée avec /quarantine/release. C'est une protection volontaire contre les spammeurs et les expéditeurs abusifs : l'e-mail n'est jamais conservé pour une livraison ultérieure.

Que dois-je faire ?

Les vérifications automatiques peuvent parfois signaler un fichier légitime. Si vous devez envoyer cette pièce jointe, contactez notre équipe support. Notre équipe connaît ce comportement et, lorsqu'un blocage s'avère être un faux positif, nous l'examinons et appliquons les mises à jour nécessaires.

Pour nous aider à résoudre le problème plus vite, indiquez :

  • Le nom et le type de fichier de la pièce jointe
  • Le riskLevel renvoyé par l'API
  • À quoi sert le fichier dans votre produit
Contacter le support →

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.

  • 401DOMAIN_NOT_VALIDATED

    Domaine de l'expéditeur non vérifié.

  • 401LISTED_SPAM_HAUS

    Le domaine de l'expéditeur est listé sur Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    L'envoi depuis des domaines connus (gmail.com, outlook.com, etc.) n'est pas autorisé.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domaine de l'en-tête From non autorisé pour cet expéditeur.

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

  • 400INVALID_JSON

    Le corps de la requête n'est pas un JSON valide.

  • 400MISSING_FROM

    Le champ from est manquant ou vide.

  • 400INVALID_FROM_FORMAT

    Le champ from doit être une adresse e-mail valide.

  • 400MISSING_SENDERNAME

    Le champ senderName est manquant ou vide.

  • 400INVALID_SENDERNAME_FORMAT

    Le champ senderName contient des caractères invalides.

  • 400MISSING_SUBJECT

    Le champ subject est manquant ou vide.

  • 400MISSING_BODY

    Le champ body est manquant ou vide.

  • 400MISSING_TOADDRESS

    Le champ to est manquant ou vide.

  • 400MISSING_TO

    Le champ to est manquant ou vide.

  • 400INVALID_TOADDRESS

    Une ou plusieurs adresses de destinataire sont mal formées.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Plus de 50 destinataires dans le tableau to.

  • 400INVALID_CCADDRESS

    Une ou plusieurs adresses cc sont mal formées.

  • 400INVALID_BCCADDRESS

    Une ou plusieurs adresses bcc sont mal formées.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc et bcc réunis comptent plus de 50 destinataires uniques.

  • 400INVALID_SCHEDULED_AT

    scheduled_at n'est pas une date valide ou est dans le passé.

  • 400INVALID_SENDER_FORMAT

    Le format de l'e-mail de l'expéditeur est invalide.

  • 400HEADER_NOT_ALLOWED

    La clé de l'en-tête personnalisé n'est pas dans la liste autorisée (List-Unsubscribe, List-Id, X-*, etc.).

  • 400INVALID_HEADER_VALUE

    La valeur de l'en-tête contient des caractères invalides (CR/LF interdits).

  • 400DANGEROUS_ATTACHMENT

    Une ou plusieurs pièces jointes ont été bloquées pour des raisons de sécurité.

  • 400INVALID_ATTACHMENT

    Le contenu d'une pièce jointe n'est pas un base64 valide.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe vaut true mais le body ne contient aucun placeholder de désinscription ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Le compte est temporairement restreint.

  • 403DAILY_LIMIT

    Limite quotidienne d'envoi d'e-mails atteinte.

  • 403MARKETING_LIMIT_REACHED

    Limite quotidienne marketing du plan gratuit atteinte : 30 e-mails marketing ou de prospection à froid par jour, comptés par destinataire sur une fenêtre glissante de 24 heures. La réponse contient limit, used, recipients et upgradeUrl. Les e-mails transactionnels partent toujours ; rien n'est mis en file d'attente.

  • 403FORBIDDEN_HTML_CONTENT

    Le HTML contient du contenu actif interdit dans les e-mails (script, iframe, form, input, button, embed, object, svg, handlers on*, liens javascript:, meta refresh…). La réponse liste les éléments détectés. Utilisez un <a> stylé au lieu de boutons ou de formulaires.

  • 403SPAM_DETECTED

    Contenu de l'e-mail signalé comme spam. La réponse inclut le quarantine_id et les instructions de libération.

  • 403SENDER_NAME_MISMATCH

    Plusieurs noms d'expéditeur détectés pour la même adresse.

  • 403FOLLOWUP_PATTERN_DETECTED

    Contenu de l'e-mail signalé comme schéma répété de relance suspecte.

  • 403SCAM_PATTERN_DETECTED

    Contenu de l'e-mail signalé comme schéma d'arnaque.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Compte suspendu après des tentatives répétées d'usurpation de l'en-tête From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Une requête avec la même Idempotency-Key est encore en cours de traitement. Attendez (Retry-After: 1) et réessayez avec la même clé.

  • 422IDEMPOTENCY_KEY_REUSED

    Cette Idempotency-Key a déjà été utilisée avec un autre corps. Utilisez une nouvelle clé pour chaque nouvel e-mail.

  • 500INTERNAL_SERVER_ERROR

    Erreur serveur inattendue. Réessayez.

  • 500PARSE_ERROR

    Échec du traitement du contenu de l'e-mail (échec du parsing MIME).

  • 500PERSIST_FAILED

    Échec de la mise en file de l'e-mail (échec d'écriture en base de données).

  • 503AUTH_UNAVAILABLE

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

  • 503UNSUBSCRIBE_UNAVAILABLE

    Service de lien de désinscription temporairement indisponible. Réessayez plus tard.