Skip to main content
Le API pubbliche di Living Security utilizzano versioni del contratto basate sulla data (YYYY-MM-DD). Il documento OpenAPI pubblicato incorpora la propria versione del contratto come info["x-contract-version"] e ogni operazione dichiara la propria fase del ciclo di vita come x-lifecycle-stage (preview, compatibility o ga). Le modifiche additive e retrocompatibili (nuove operazioni, nuovi campi opzionali) vengono rilasciate all’interno della versione corrente del contratto. Una nuova versione del contratto viene pubblicata solo per le modifiche che causano incompatibilità, insieme a una voce in questa pagina che descrive la modifica e il percorso di migrazione.

​
Aggiornamenti della documentazione

2026-08-25 — Le guide /v1 e l’elenco servers di OpenAPI ora indicano gli host regionali attivi per gli Stati Uniti e l’UE. Si tratta di un chiarimento della documentazione. La versione del contratto rimane invariata. Consultare Regioni.

​
2026-07-01

Le API pubbliche /v1 supportano questa versione del contratto. È possibile bloccarla tramite Living-Security-Version: 2026-07-01 oppure utilizzare la versione predefinita assegnata al proprio service account. Consultare la guida rapida alle API per la prima richiesta, Autenticazione per le chiavi API e OAuth e Regioni per l’host corretto.

​
2026-08-05

Questa data identifica il contratto di compatibilità /api/v1 legacy, distinto dagli altri. Non è un valore Living-Security-Version per le nuove API /v1.
  • Persone: cercare le persone dell’organizzazione (GET /people/search) e recuperare l’appartenenza di una persona (GET /people/{personId}/membership).
  • Chiavi di accesso API: creare, elencare, ruotare e revocare le chiavi di accesso API (POST /access-keys, GET /access-keys, POST /access-keys/{id}/rotate, DELETE /access-keys/{id}).
Tutte le operazioni di questa versione sono pubblicate nella fase del ciclo di vita compatibility. Consultare la panoramica delle API pubbliche per autenticazione, paginazione e gestione degli errori, e la policy di compatibilità e deprecazione per l’evoluzione di questo contratto.