Recevoir des e-mails : Pièces jointes

Obtenir une pièce jointe

Téléchargez une pièce jointe d'un message en base64 dans le résultat de la commande.

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

Utilisez l'attachment_id de get_messages (incluez attachments). Pour les gros fichiers, Raw Message télécharge directement le binaire.

!

Une pièce jointe bloquée par l'analyse de sécurité n'est pas renvoyée.

Arguments

  • idstringobligatoire

    Le message_uid.

  • attachment_idstringobligatoire

    L'id de la pièce jointe.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "get_attachment",
        args: {
          id: "Vj0xQUJDMTIz",
          attachment_id: "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42"
        }
      }
    ]
  },
  { 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": "get_attachment",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "attachment_id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
        "file_name": "invoice.pdf",
        "content_type": "application/pdf",
        "size_bytes": 48213,
        "content": "JVBERi0xLjcKJcfsj6IK…",
        "inline": false
      }
    }
  ]
}

Champs de la réponse

  • content

    Le fichier en base64.

  • inline

    true pour les images intégrées dans le corps (cid).

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.

  • CMDNOT_FOUND

    Le message, la conversation ou le dossier n'existe pas pour ce token.

  • CMDFILE_BLOCKED

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

  • CMDINTERNAL

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