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_accountsle partage avec les sous-comptes directs,descendantsle partage avec tous les comptes situés sous lui, à toute profondeur, etaccountsle partage seulement avec les comptes que vous indiquez.shared_with_account_ids: les comptes autorisés à utiliser l'expéditeur, avecaccountsseulement. De 1 à 100 identifiants de compte.excluded_account_ids: les comptes auxquels l'expéditeur est refusé, avecsub_accountsoudescendantsseulement. Jusqu'à 100 identifiants de compte. Avecdescendants, 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}accepteremove_tags. Avecfalse, les étiquettes detagssont ajoutées et aucune étiquette existante n'est retirée. La valeur par défaut,true, conserve le comportement actuel :tagsremplace les étiquettes du contact.POST /lists/{list_id}/contacts/tagaveccontact_idsétiquette maintenant chaque identifiant qui correspond à un contact de la liste, et retourne les autres dansskipped_contact_ids. Auparavant, un seul identifiant inconnu faisait échouer toute la requête avec une erreur400.POST /lists/{list_id}/contacts/tagetPOST /lists/{list_id}/contacts/untagne comptent qu'une fois un identifiant répété danscontact_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é parPOST /v2/emails(csv,doc,docx,calendar,jpeg,pdf,png,xlsetxlsx).
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
GETetPATCH /brands/default/domains/defaultretournent maintenant le domaineforward.PATCH /brands/default/domains/defaultaccepte un domaineforwardqui 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
400inclut maintenantexpected: l'enregistrement DNS à créer (host,typeetvalue). - 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 de500lorsque les attributs personnalisés ou les en-têtes d'un courriel sont absents ounull.