Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Notre API est en constante évolution. La grande majorité des modifications ajoutent simplement de nouvelles fonctionnalités, mais nous introduisons parfois des changements cassants qui peuvent vous obliger à ajuster votre intégration.
Cette page explique quels changements peuvent être considérés comme des changements cassants dans notre API. Il fournit également des exemples de modifications qui ne sont pas considérées comme des changements cassants.
Importante
Nous nous réservons le droit de corriger les bogues, d’ajuster les fonctionnalités pour nous conformer à nos politiques de partie de service et à nos obligations légales, et de modifier les fonctionnalités et les produits en alpha et bêta sans préavis.
Changements cassants
Les types de modifications suivants sont qualifiés de changements cassants :
- Suppression d’un champ
- Changement d’un champ de non obligatoire à obligatoire
- Ajout de nouvelles règles de validation
- Modification du type de données d’un champ (par exemple, tableau d’ID convertis en tableau d’objets)
- Modification de la limitation des demandes
- Réduction du nombre d’objets retournés par les réponses
Lorsque nous introduisons un changement cassant dans notre API, nous prenons en charge deux versions de l’API en production, l’une avec et l’autre sans changement cassant, pendant 60 jours. En outre, nous informerons les utilisateurs de l’API de ces modifications et de la façon d’atteindre correctement chaque version pendant la période de rupture des modifications. Si votre compte d’utilisateur est activé pour l’API, vous recevrez automatiquement des communications de changement cassants.
Exemples de modifications non cassants
Les types de modifications suivants ne sont pas considérés comme des changements cassants. Veuillez noter que cette liste n’est pas exhaustive ; il ne s’agit que de quelques exemples de modifications non cassants.
- Ajout d’un nouveau champ non obligatoire
- Ajout d’un nouveau service
- Ajout de métriques/dimensions aux rapports
- Ajout d’un nouveau type de rapport
- Dépréciation d’un champ sans le supprimer
- Réduction ou augmentation du nombre de rapports simultanés autorisés
- Ajout d’un nouveau champ à l’un de nos flux de données au niveau du journal
- Modifier l’ordre des champs d’un objet, des objets d’un tableau, et ainsi de suite