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.
https://g.sendcorex.com/v1command: upload_attachmentSans 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é.
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.
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_namestringobligatoireNom du fichier affiché au destinataire.
contentstringobligatoireLe 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_typestringfacultatifType MIME. Par défaut
application/octet-stream.compose_uidstringfacultatifAjoute 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_uidEnvoyez-le avec les fichiers suivants et avec la commande d'envoi.
attachment.idUtilisez-le dans
attachment_idsoudelete_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.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus 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.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INVALID_ATTACHMENTLe contenu d'une pièce jointe n'est pas du base64 valide.
- CMD
ATTACHMENTS_TOO_LARGELes 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.
- CMD
TOO_MANY_OPEN_COMPOSESLa 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.
- CMD
FILE_BLOCKEDUn fichier a été bloqué par l'analyse de sécurité.
- CMD
ALREADY_SENTLe compose_uid appartient à un e-mail déjà envoyé.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.