YYYY-MM-DD). Le document OpenAPI publié intègre sa version de contrat sous la forme
info["x-contract-version"], et chaque opération déclare son stade de cycle de vie
sous la forme x-lifecycle-stage (preview, compatibility ou ga).
- La spécification actuelle est toujours disponible à l’adresse
/v1-reference/openapi-v1.json. - Des instantanés de référence versionnés sont disponibles à l’adresse
/v1-reference/openapi/<version>.json, par exemple/v1-reference/openapi/2026-07-01.json.
Mises à jour de la documentation
2026-08-25 — Les guides/v1 et la liste servers d’OpenAPI mentionnent désormais les hôtes régionaux actifs
des États-Unis et de l’UE. Il s’agit d’une clarification de la documentation. La version
de contrat reste inchangée. Consultez Régions.
2026-07-01
L’API publique/v1 prend en charge cette version de contrat. Épinglez-la à l’aide de
Living-Security-Version: 2026-07-01, ou utilisez la version par défaut attribuée
à votre compte de service.
Consultez le guide de démarrage rapide de l’API pour votre première requête,
Authentification pour les clés d’API et OAuth, et
Régions pour connaître l’hôte approprié.
2026-08-05
Cette date identifie le contrat de compatibilité/api/v1 distinct et hérité.
Il ne s’agit pas d’une valeur Living-Security-Version pour la nouvelle API /v1.
- Personnes : recherchez les personnes de l’organisation (
GET /people/search) et récupérez l’appartenance d’une personne (GET /people/{personId}/membership). - Clés d’accès à l’API : créez, répertoriez, renouvelez et révoquez des clés d’accès à l’API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility.
Consultez la présentation de l’API publique pour
l’authentification, la pagination et la gestion des erreurs, ainsi que la
politique de compatibilité et d’obsolescence
pour savoir comment ce contrat évolue.