L’ajout des pièces jointes peut se faire de deux façons :
/api/attachment/download
/api/attachment
Les documents chargés sont rattachés à un compte AR24 et possèdent un identifiant unique. Vous pouvez consulter tous les fichiers rattachés à un utilisateur via la route /api/user/attachment/.
/api/user/attachment/
Lors de la rédaction d’un courrier recommandé, vous pouvez ajouter des documents rattachés au compte expéditeur avec le paramètre attachment (tableau d’identifiant de documents). Ainsi vous pouvez réutiliser à tout moment des documents rattachés au compte expéditeur dans différents courriers recommandés
attachment
Les documents chargés sur l’API ne peuvent pas être supprimés par raison de sécurité. Tous les documents chargés depuis plus de 30 jours qui n’ont pas été utilisés dans un courrier recommandé sont automatiquement supprimés.
Vous avez la possibilité de charger un document via une URL avec la route /api/attachment/download
Les paramètres attendus sont les suivants :
token
id_user
file_url
file_name
Vous obtenez alors un retour de notre API avec le statut SUCCESS et l’identifiant du document nouvellement chargé (file_id). (Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#post-upload-an-attachment-from-a-url
SUCCESS
file_id
Vous avez la possibilité de charger un document avec la route /api/attachment
file
À titre d’exemple, vous pouvez charger un document en ligne de commande en effectuant la commande : curl -v -F id_user=[id_user] -F token=[token] -F file=@test.pdf https://sandbox.ar24.fr/api/attachment/
Vous obtenez alors un retour de notre API avec le statut SUCCESS et l’identifiant du document nouvellement chargé (file_id). (Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#post-upload-an-attachment
Vous avez la possibilité de visualiser tous les documents rattachés à un compte AR24 via la route /api/user/attachment et ainsi récupérer les identifiants uniques que vous pourrez utiliser dans vos envois.
/api/user/attachment
Les paramètres obligatoires attendus sont les suivants :
Vous obtenez alors un retour de notre API avec le statut SUCCESS et la liste des documents rattachés à cet utilisateur. (Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#get-list-attachments-for-a-user
Lors de l’envoi d’un courrier recommandé électronique, vous avez la possibilité d’ajouter jusqu’à 256Mo de pièce-jointes à votre pli. Vous devez, au préalable de l’envoi, charger les pièces-jointes sur AR24 pour les rattacher à un compte expéditeur du courrier (voir les parties 1 et 2)
Lors de l’appel à la route /api/mail, l’ajout de pièce-jointes s’effectue grâce au paramètre attachment. Ce paramètre est un tableau d’identifiants de pièce-jointes.
/api/mail
Par exemple, l’expéditeur (paramètre id_user) a chargé les documents ayant comme identifiants : 123, 456 et 789. Il pourra alors utiliser un ou plusieurs de ces documents comme pièce-jointe de son courrier recommandé électronique en ajoutant les paramètres suivants à son appel à /api/mail : attachment[0] avec comme valeur 123, attachment[1] avec comme valeur 456.
attachment[0]
attachment[1]
Créer un compte expéditeur via l’API
Envoyer un courrier recommandé eIDAS via l’API
Facturation des consommations via l’API
Gérer les demandes de modification de coordonnées destinataire depuis l’API