# 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`.
