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 étape du 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 nomment 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
du contrat demeure 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 désigne le contrat de compatibilité/api/v1 hérité distinct.
Il ne s’agit pas d’une valeur Living-Security-Version pour la nouvelle API /v1.
- Personnes : rechercher les personnes de l’organisation (
GET /people/search) et récupérer l’appartenance d’une personne (GET /people/{personId}/membership). - Clés d’accès à l’API : créer, lister, effectuer la rotation et révoquer des clés d’accès à l’API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility du cycle de vie.
Consultez la vue d’ensemble de l’API publique pour
l’authentification, la pagination et la gestion des erreurs, ainsi que la
politique de compatibilité et de dépréciation
pour savoir comment ce contrat évolue.