> ## 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.

# Col·lecció de Postman

> Importeu la col·lecció de Postman de l'API pública de Living Security generada automàticament, enganxeu una clau d'API i feu crides a /v1 en qüestió de minuts.

La col·lecció de Postman de l'API v1 de Living Security es genera a partir de la mateixa
especificació OpenAPI que alimenta la [referència de l'API v1](/v1-reference/openapi-v1.json),
de manera que sempre coincideix amb el contracte publicat. Cobreix totes les operacions `/v1`,
agrupades per recurs, amb l'autenticació preconfigurada.

## Baixada

<Info>
  Els enllaços de baixada us demanaran que inicieu la sessió amb el vostre compte de Living Security
  abans de lliurar-vos el fitxer.
</Info>

<CardGroup cols={1}>
  <Card title="Col·lecció de l'API v1 de Living Security" icon="download">
    Col·lecció de Postman v2.1 amb totes les operacions `/v1` i l'autenticació Basic
    preconfigurada. La variable `baseUrl` de la col·lecció és buida: seleccioneu un
    entorn regional abans d'enviar cap sol·licitud.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Baixa la col·lecció</a>
  </Card>

  <Card title="Entorn de producció (EUA)" icon="download">
    `baseUrl` preconfigurat amb `https://api.us-east-1.livingsecurity.ai/v1`, amb
    les variables `apiKeySecret` i `contractVersion` buides per emplenar.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Baixa l'entorn de producció dels EUA</a>
  </Card>

  <Card title="Entorn de producció (UE)" icon="download">
    `baseUrl` preconfigurat amb `https://api.eu-west-1.livingsecurity.ai/v1`, amb
    les variables `apiKeySecret` i `contractVersion` buides per emplenar.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Baixa l'entorn de producció de la UE</a>
  </Card>

  <Card title="Plantilla d'entorn" icon="download">
    Les mateixes variables amb un `baseUrl` en blanc, per a configuracions que no són de producció.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Baixa la plantilla d'entorn</a>
  </Card>
</CardGroup>

## Configuració a Postman

<Steps>
  <Step title="Importeu els fitxers">
    A Postman, trieu **Import** i deixeu anar el fitxer de la col·lecció i l'entorn
    Production (US) o Production (EU) que correspongui a
    l'organització. Vegeu [Regions](/ca/developers/v1/regions).
  </Step>

  <Step title="Creeu una clau d'API">
    Al Dashboard, obriu **Settings → Integrations & Developers →
    Developer Hub**, creeu un compte de servei i creeu una clau d'API. El secret de la clau comença per `lsk_live_` i
    només es mostra una vegada: copieu-lo immediatament. Per a més informació, vegeu
    [Claus d'API](/ca/developers/developer-hub/api-keys).
  </Step>

  <Step title="Enganxeu el secret">
    Definiu la variable `apiKeySecret`, ja sigui a l'entorn importat
    (recomanat; és una variable de tipus secret) o a la pestanya
    **Variables** de la col·lecció.
  </Step>

  <Step title="Envieu una sol·licitud">
    Seleccioneu l'entorn regional importat, obriu qualsevol sol·licitud (per exemple,
    **Organization → Retrieve the organization**) i premeu **Send**. No
    envieu res fins que hàgiu seleccionat un entorn; la variable `baseUrl` de la col·lecció és buida
    expressament.
  </Step>
</Steps>

## Com es preconfigura l'autenticació

La col·lecció defineix l'autenticació Basic a nivell de col·lecció amb el nom d'usuari `apikey`
i la contrasenya `{{apiKeySecret}}`. L'API accepta el secret de la clau en qualsevol dels dos
camps de l'autenticació Basic, de manera que funciona tal com està un cop s'ha definit la variable.

Si preferiu l'autenticació de tipus bearer, canvieu el tipus d'**Authorization**
de la col·lecció a **Bearer Token** i useu `{{apiKeySecret}}` com a testimoni: l'API
accepta el mateix secret d'ambdues maneres.

Utilitzar una capçalera Bearer amb una clau d'API no requereix OAuth. Per utilitzar OAuth,
establiu **Bearer Token** al vostre testimoni d'accés OAuth en lloc del secret de la clau d'API.
Vegeu [Autenticació](/ca/developers/v1/authentication) per triar un mètode i
[Credencials de client OAuth](/ca/developers/v1/oauth) per configurar el testimoni i el client.

## Capçalera de versió del contracte

Cada sol·licitud inclou una capçalera `Living-Security-Version` preconfigurada amb
`{{contractVersion}}`, desactivada per defecte. Deixeu-la desactivada per utilitzar la versió del contracte
fixada per a la vostra organització. Activeu-la per fixar la sol·licitud a una
versió publicada concreta; per a les versions publicades, vegeu el [registre de canvis](/ca/developers/v1/changelog).

## Paràmetres de consulta i cossos

Els filtres dels punts finals de llista (`limit`, `page_token` i els filtres específics de cada recurs)
s'inclouen a cada sol·licitud però estan desactivats, de manera que una importació nova crida correctament
a tots els punts finals. Activeu i empleneu els que necessiteu; vegeu
[Paginació](/ca/developers/v1/pagination) per saber com funciona `page_token`. Els cossos
de sol·licitud de les operacions `POST` venen emplenats amb valors de marcador de posició tipats.

<Note>
  La col·lecció es regenera a partir de l'especificació OpenAPI publicada a cada canvi
  de contracte: baixeu-ne una còpia nova en lloc d'editar les sol·licituds que
  vulgueu mantenir actualitzades.
</Note>


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