Skip to main content
La collection Postman della Living Security API v1 viene generata dalla stessa specifica OpenAPI che alimenta il riferimento API v1, pertanto corrisponde sempre al contratto pubblicato. Copre tutte le operazioni /v1, raggruppate per risorsa, con l’autenticazione già preconfigurata.

​
Download

I link per il download richiedono di accedere con il proprio account Living Security prima che il file venga reso disponibile.

Collection Living Security API v1

Postman Collection v2.1 con tutte le operazioni /v1 e l’autenticazione Basic preconfigurata. Il valore baseUrl della collection è vuoto: selezionate un ambiente regionale prima di inviare una richiesta.Scarica la collection

Ambiente di produzione (US)

baseUrl preimpostato su https://api.us-east-1.livingsecurity.ai/v1, con le variabili apiKeySecret e contractVersion vuote da compilare.Scarica l’ambiente di produzione US

Ambiente di produzione (EU)

baseUrl preimpostato su https://api.eu-west-1.livingsecurity.ai/v1, con le variabili apiKeySecret e contractVersion vuote da compilare.Scarica l’ambiente di produzione EU

Modello di ambiente

Le stesse variabili con un valore baseUrl vuoto, per configurazioni non di produzione.Scarica il modello di ambiente

​
Configurazione in Postman

1

Importare i file

In Postman, scegliete Importazione e trascinate il file della collection insieme all’ambiente Production (US) o Production (EU) corrispondente all’organizzazione. Consultate Regioni.
2

Creare una chiave API

Nella Dashboard, aprite Impostazioni → Integrazioni & Developers → Developer Hub, create un account di servizio e create una chiave API. Il secret della chiave inizia con lsk_live_ e viene mostrato una sola volta: copiatelo subito. Per i dettagli, consultate Chiavi API.
3

Incollare il secret

Impostate la variabile apiKeySecret, nell’ambiente importato (consigliato; è una variabile di tipo secret) oppure nella scheda Variabili della collection.
4

Inviare una richiesta

Selezionate l’ambiente regionale importato, aprite una richiesta qualsiasi, ad esempio Organizzazione → Retrieve the organization, e fate clic su Invia. Non inviate richieste finché non è stato selezionato un ambiente: il valore baseUrl della collection è vuoto di proposito.

​
Come è preconfigurata l’autenticazione

La collection imposta l’autenticazione Basic a livello di collection con nome utente apikey e password {{apiKeySecret}}. L’API accetta il secret della chiave in entrambi i campi dell’autenticazione Basic, quindi la configurazione funziona così com’è una volta impostata la variabile. Se preferite l’autenticazione bearer, impostate il tipo di Authorization della collection su Bearer Token e usate {{apiKeySecret}} come token: l’API accetta lo stesso secret in entrambi i modi. L’uso di un header Bearer con una chiave API non richiede OAuth. Per usare OAuth, impostate Bearer Token sul vostro token di accesso OAuth anziché sul secret della chiave API. Consultate Autenticazione per scegliere un metodo e Credenziali client OAuth per la configurazione di token e client.

​
Header della versione del contratto

Ogni richiesta include un header Living-Security-Version preimpostato su {{contractVersion}}, disabilitato per impostazione predefinita. Lasciatelo disabilitato per utilizzare la versione del contratto fissata per la vostra organizzazione. Abilitatelo per vincolare la richiesta a una specifica versione pubblicata; consultate il changelog per le versioni pubblicate.

​
Parametri di query e body

I filtri degli endpoint di elenco (limit, page_token e i filtri specifici della risorsa) sono inclusi in ogni richiesta ma disabilitati, in modo che una nuova importazione richiami correttamente ogni endpoint. Abilitate e compilate quelli necessari; consultate Paginazione per il funzionamento di page_token. I body delle richieste per le operazioni POST sono precompilati con valori segnaposto tipizzati.
La collection viene rigenerata dalla specifica OpenAPI pubblicata a ogni modifica del contratto: scaricate una copia aggiornata anziché modificare le richieste che desiderate mantenere aggiornate.