Compatibilité de l'API

Engagement de versionnementCopier le lien de la section

L'API est versionnée dans le chemin de l'URL. Aujourd'hui, seule /v1 existe.

• Les changements de la v1 sont uniquement additifs. Nous ajoutons des endpoints, des champs de requête facultatifs, des champs de réponse et des types d'événements. Nous ne supprimons ni ne renommons aucun champ, ne changeons pas sa signification et ne rendons pas obligatoire un champ facultatif. Votre client doit ignorer les champs de réponse qu'il ne connaît pas.
• Un changement incompatible est publié sous /v2. Nous l'annonçons au moins 180 jours avant sa disponibilité, et /v1 continue de fonctionner en parallèle pendant 180 jours après la sortie de /v2.

Envoi séparé par destinataireCopier le lien de la section

Lorsque POST /v1/transactional/send contient plusieurs destinataires dans to, chaque destinataire reçoit sa propre copie du message, avec son propre identifiant de message. Il n'y a pas de message partagé et aucun Cc visible : aucun destinataire ne voit les adresses des autres. La requête n'accepte ni cc ni bcc. Si tous les destinataires doivent se voir mutuellement, ce n'est pas possible en v1.

Taille des pièces jointesCopier le lien de la section

Un message comporte au plus 10 pièces jointes et au plus 10 MiB au total, mesurés après décodage Base64. Une requête qui dépasse la limite est refusée avec 400 VALIDATION_FAILED. Voir Pièces jointes.

Portée de l'idempotenceCopier le lien de la section

X-Idempotency-Key est accepté sur exactement deux endpoints : POST /v1/transactional/send et POST /v1/transactional/send-batch. Aucun autre endpoint ne le lit ; rejouer tout autre POST peut donc répéter son effet. Voir Idempotence.