# Gestion des versions

> L’API Emailit en est à la version 2. Comment la version est définie, ce qui change sans nouvelle version, l’API v1 obsolète et le passage aux ID d’objets préfixés.

La version de l’API fait partie de l’URL de base : chaque requête indique donc la version pour laquelle elle a été écrite. Cette page présente les versions existantes, ce qui peut changer au sein d’une version et la façon dont les ID d’objets ont changé en 2026.

## Versions

| Version | URL de base | Statut |
| --- | --- | --- |
| v2 | `https://api.emailit.com/v2` | Actuelle. Publiée en octobre 2025. Tout ce qui figure dans cette référence concerne la v2. |
| v1 | `https://api.emailit.com/v1` | Obsolète. La génération précédente de l’API. Elle ne reçoit plus de nouvelles fonctionnalités et n’est plus documentée. |

Si vous appelez encore la v1, migrez votre intégration vers la v2. Les [SDK](/fr/docs/sdks/) utilisent tous la v2.

## Changements au sein de la v2

Emailit enrichit la v2 sans changer la version dans l’URL. Ces changements peuvent intervenir à tout moment :

- Nouveaux endpoints et nouvelles ressources.
- Nouveaux paramètres de requête et en-têtes facultatifs.
- Nouveaux champs dans les objets de réponse et les payloads de webhook.
- Nouveaux types d’événements, statuts et autres valeurs d’énumération.

Écrivez des clients qui les tolèrent : ignorez les champs de réponse que vous ne reconnaissez pas, n’échouez pas sur un statut ou un type d’événement inconnu, et ne dépendez pas de l’ordre des champs dans un objet JSON.

Les changements de l’API sont annoncés dans le [journal des modifications](/fr/docs/changelog/).

## ID d’objets

En janvier 2026, tous les objets sont passés à des ID préfixés : un préfixe de type suivi de 27 lettres et chiffres, comme `em_4KYof1ZzXndZE2VPi0DgULiekG8` pour un e-mail ou `dom_4K468YrjOkR1wwdhqiO0G9XEUey` pour un domaine. Tous les endpoints acceptent et renvoient ces ID. Pour la liste des préfixes, consultez [ID d’objets](/fr/docs/api-reference/#object-ids).

- Stockez les ID sous forme de chaînes et comparez-les à l’identique. Ils sont sensibles à la casse.
- Les domaines d’envoi qui existaient avant le changement conservent des ID commençant par `sd_` ou `sed_`. Ils fonctionnent partout où un ID `dom_` fonctionne : ne validez donc pas les ID de domaine d’après leur préfixe.
- Les clés API sont des secrets, pas des ID. Les nouvelles clés commencent par `secret_`, et les clés plus anciennes sans préfixe continuent de fonctionner. L’ID d’une clé API commence par `key_`.

## Voir aussi

  - [Journal des modifications](/fr/docs/changelog/): Nouvelles fonctionnalités et changements, du plus récent au plus ancien.
  - [Référence de l’API](/fr/docs/api-reference/): URL de base, authentification et ressources.

---
Source: https://emailit.com/fr/docs/api-reference/versioning/