YYYY-MM-DD). El document OpenAPI publicat incorpora la seva versió de contracte com a
info["x-contract-version"], i cada operació declara la seva etapa del cicle de vida
com a x-lifecycle-stage (preview, compatibility o ga).
- L’especificació actual sempre està disponible a
/v1-reference/openapi-v1.json. - Les instantànies de referència versionades estan disponibles a
/v1-reference/openapi/<version>.json, per exemple/v1-reference/openapi/2026-07-01.json.
Actualitzacions de la documentació
2026-08-25 — Les guies de/v1 i la llista de servers d’OpenAPI ara indiquen els
hosts regionals actius dels EUA i la UE. Es tracta d’una aclaració de la documentació. La versió
de contracte no ha canviat. Vegeu Regions.
2026-07-01
L’API pública de/v1 admet aquesta versió de contracte. Fixeu-la mitjançant
Living-Security-Version: 2026-07-01, o utilitzeu la versió predeterminada assignada
al vostre compte de servei.
Consulteu la Guia d’inici ràpid de l’API per fer la primera sol·licitud,
Authentication per a les claus d’API i OAuth, i
Regions per conèixer el host correcte.
2026-08-05
Aquesta data identifica el contracte de compatibilitat heretat independent de/api/v1.
No és un valor de Living-Security-Version per a la nova API de /v1.
- People: cerqueu les persones de l’organització (
GET /people/search) i recupereu la pertinença d’una persona (GET /people/{personId}/membership). - API access keys: creeu, llisteu, roteu i reviqueu claus d’accés a l’API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility.
Consulteu la Visió general de l’API pública per a
l’autenticació, la paginació i la gestió d’errors, i la
política de compatibilitat i obsolescència
per saber com evoluciona aquest contracte.
