Cakemail
Journal des modifications de l'API

Next-gen API v1.28

Partage d'expéditeurs

Un compte peut maintenant partager un expéditeur avec les comptes situés sous lui. POST /brands/default/senders et PATCH /brands/default/senders/{sender_id} acceptent trois nouveaux champs :

  • sharing : qui, en plus du compte propriétaire, peut utiliser l'expéditeur. none (la valeur par défaut) le réserve au compte propriétaire, sub_accounts le partage avec les sous-comptes directs, descendants le partage avec tous les comptes situés sous lui, à toute profondeur, et accounts le partage seulement avec les comptes que vous indiquez.
  • shared_with_account_ids : les comptes autorisés à utiliser l'expéditeur, avec accounts seulement. De 1 à 100 identifiants de compte.
  • excluded_account_ids : les comptes auxquels l'expéditeur est refusé, avec sub_accounts ou descendants seulement. Jusqu'à 100 identifiants de compte. Avec descendants, exclure un compte exclut aussi tous les comptes situés sous lui.

Les deux listes ne peuvent nommer que des comptes situés sous le compte propriétaire.

Les réponses sur les expéditeurs incluent maintenant sharing, les deux listes et account_id, le compte propriétaire de l'expéditeur. Un sous-compte voit les expéditeurs partagés avec lui dans GET /brands/default/senders, peut les lire par identifiant et peut les utiliser partout où un sender_id est accepté. Seul le compte propriétaire peut modifier ou supprimer un expéditeur.

Un expéditeur créé avant cette version indique sharing: "legacy". Vous ne pouvez pas définir legacy : définissez un autre mode avec PATCH pour choisir qui peut utiliser l'expéditeur.

Limite de débit de l'API Courriel

POST /v2/emails accepte maintenant un nombre limité de soumissions par compte sur toute fenêtre de 60 secondes (actuellement 200). Le compte visé est celui sur lequel la requête agit : le compte du jeton lui-même, ou celui indiqué dans account_id. Au-delà de la limite, la requête reçoit une réponse 429 dont le champ detail donne la limite, la fenêtre et retry_in, soit le nombre de secondes à attendre.

Chaque réponse 429 d'un point de terminaison à débit limité comporte maintenant aussi un en-tête Retry-After avec le même nombre de secondes.

GET /v2/emails/{email_id} et GET /v2/emails/{email_id}/render appliquent maintenant les limites de débit qu'ils déclaraient déjà.

Contacts

  • PATCH /lists/{list_id}/contacts/{contact_id} accepte remove_tags. Avec false, les étiquettes de tags sont ajoutées et aucune étiquette existante n'est retirée. La valeur par défaut, true, conserve le comportement actuel : tags remplace les étiquettes du contact.
  • POST /lists/{list_id}/contacts/tag avec contact_ids étiquette maintenant chaque identifiant qui correspond à un contact de la liste, et retourne les autres dans skipped_contact_ids. Auparavant, un seul identifiant inconnu faisait échouer toute la requête avec une erreur 400.
  • POST /lists/{list_id}/contacts/tag et POST /lists/{list_id}/contacts/untag ne comptent qu'une fois un identifiant répété dans contact_ids.

Paramètres des courriels transactionnels et des pièces jointes

usage_limits dans GET /accounts/{account_id} et PATCH /accounts/{account_id} comporte deux nouveaux champs :

  • use_transactional_emails : indique si le compte peut envoyer des courriels transactionnels.
  • attachment_types : un paramètre par type de pièce jointe accepté par POST /v2/emails (csv, doc, docx, calendar, jpeg, pdf, png, xls et xlsx).

GET retourne la valeur qui s'applique au compte : la sienne ou, à défaut, celle du compte supérieur le plus proche qui en définit une. Avec PATCH, un partenaire ne peut modifier qu'un paramètre activé pour son propre compte, et seulement sur un compte qu'il gère. Une requête refusée ne change rien.

Domaines

  • GET et PATCH /brands/default/domains/default retournent maintenant le domaine forward.
  • PATCH /brands/default/domains/default accepte un domaine forward qui a le même nom d'hôte qu'un domaine de suivi ou de retour qui réussit la vérification.
  • Lorsqu'un domaine de suivi ou de retour échoue à la vérification, chaque erreur de la réponse 400 inclut maintenant expected : l'enregistrement DNS à créer (host, type et value).
  • Un domaine de retour qui contient un port ou des informations d'utilisateur est maintenant refusé.

Corrections

  • GET /v2/emails/{email_id} ne retourne plus de 500 lorsque les attributs personnalisés ou les en-têtes d'un courriel sont absents ou null.
Last modified on