Recevoir des e-mails : Pièces jointes

Téléverser une pièce jointe

Envoyez un fichier avant l'envoi de l'e-mail. Utilisez le compose_uid renvoyé dans send_email, reply, forward ou schedule_send.

POSThttps://g.sendcorex.com/v1command: upload_attachment
i

Sans compose_uid, un nouveau est créé. Renvoyez-le avec les fichiers suivants du même e-mail. Chaque fichier est analysé avant d'être enregistré.

i

Pour des fichiers ponctuels, vous pouvez aussi sauter cette étape et les envoyer directement dans attachments de la commande d'envoi.

!

La requête entière est limitée à 1 Mo, et le base64 grossit le fichier d'environ 33 %, donc cette commande accepte des fichiers jusqu'à environ 700 Ko. Pour des fichiers plus gros (jusqu'à 25 Mo), utilisez Téléverser un gros fichier, qui reçoit le fichier sous forme de données binaires.

i

Limites : 20 fichiers et 25 Mo par e-mail ; par boîte aux lettres, 50 e-mails avec des fichiers pas encore envoyés et 500 Mo au total. Les fichiers non envoyés sous 48 heures, et non utilisés par un brouillon ou un e-mail programmé, sont supprimés.

Arguments

  • file_namestringobligatoire

    Nom du fichier affiché au destinataire.

  • contentstringobligatoire

    Le fichier en base64 (une URL data: est aussi acceptée). La requête est limitée à 1 Mo, soit environ 700 Ko de fichier.

  • content_typestringfacultatif

    Type MIME. Par défaut application/octet-stream.

  • compose_uidstringfacultatif

    Ajoute le fichier à un e-mail que vous êtes déjà en train de préparer.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "upload_attachment",
        args: {
          file_name: "invoice.pdf",
          content: "JVBERi0xLjcKJcfsj6IK…",
          content_type: "application/pdf"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Réponse

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "upload_attachment",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "compose_uid": "Vj0xQ01QMDAx",
        "attachment": {
          "id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
          "file_name": "invoice.pdf",
          "size_bytes": 48213,
          "content_type": "application/pdf"
        }
      }
    }
  ]
}

Champs de la réponse

  • compose_uid

    Envoyez-le avec les fichiers suivants et avec la commande d'envoi.

  • attachment.id

    Utilisez-le dans attachment_ids ou delete_attachment.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINVALID_ATTACHMENT

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

  • CMDATTACHMENTS_TOO_LARGE

    Les pièces jointes de l'e-mail dépassent 25 Mo au total, ou la boîte aux lettres a déjà 500 Mo de fichiers envoyés en attente d'envoi.

  • CMDTOO_MANY_OPEN_COMPOSES

    La boîte aux lettres a 50 e-mails avec des fichiers pas encore envoyés. Envoyez-les, ou attendez que ceux qui ne sont pas utilisés soient supprimés au bout de 48 heures.

  • CMDFILE_BLOCKED

    Un fichier a été bloqué par l'analyse de sécurité.

  • CMDALREADY_SENT

    Le compose_uid appartient à un e-mail déjà envoyé.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.