> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection Postman

> Importate la collection Postman generata della Living Security Public API, incollate una chiave API e richiamate /v1 in pochi minuti.

La collection Postman della Living Security API v1 viene generata dalla stessa
specifica OpenAPI che alimenta il [riferimento API v1](/v1-reference/openapi-v1.json),
pertanto corrisponde sempre al contratto pubblicato. Copre tutte le operazioni `/v1`,
raggruppate per risorsa, con l'autenticazione già preconfigurata.

## Download

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

<CardGroup cols={1}>
  <Card title="Collection Living Security API v1" icon="download">
    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.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Scarica la collection</a>
  </Card>

  <Card title="Ambiente di produzione (US)" icon="download">
    `baseUrl` preimpostato su `https://api.us-east-1.livingsecurity.ai/v1`, con
    le variabili `apiKeySecret` e `contractVersion` vuote da compilare.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Scarica l'ambiente di produzione US</a>
  </Card>

  <Card title="Ambiente di produzione (EU)" icon="download">
    `baseUrl` preimpostato su `https://api.eu-west-1.livingsecurity.ai/v1`, con
    le variabili `apiKeySecret` e `contractVersion` vuote da compilare.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Scarica l'ambiente di produzione EU</a>
  </Card>

  <Card title="Modello di ambiente" icon="download">
    Le stesse variabili con un valore `baseUrl` vuoto, per configurazioni non di produzione.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Scarica il modello di ambiente</a>
  </Card>
</CardGroup>

## Configurazione in Postman

<Steps>
  <Step title="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](/it/developers/v1/regions).
  </Step>

  <Step title="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](/it/developers/developer-hub/api-keys).
  </Step>

  <Step title="Incollare il secret">
    Impostate la variabile `apiKeySecret`, nell'ambiente importato
    (consigliato; è una variabile di tipo secret) oppure nella scheda
    **Variabili** della collection.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/it/developers/v1/authentication) per scegliere un metodo e
[Credenziali client OAuth](/it/developers/v1/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](/it/developers/v1/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](/it/developers/v1/pagination) per il funzionamento di `page_token`. I body
delle richieste per le operazioni `POST` sono precompilati con valori segnaposto tipizzati.

<Note>
  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.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.