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

> Importez la collection Postman générée de l'API publique Living Security, collez une clé d'API et appelez /v1 en quelques minutes.

La collection Postman de l'API Living Security v1 est générée à partir de la même
spécification OpenAPI que celle qui alimente la [Référence de l'API v1](/v1-reference/openapi-v1.json),
elle correspond donc toujours au contrat publié. Elle couvre les `/v1` opérations,
regroupées par ressource, avec l'authentification préconfigurée.

## Téléchargement

<Info>
  Les liens de téléchargement vous invitent à vous connecter avec votre compte Living Security
  avant que le fichier ne soit fourni.
</Info>

<CardGroup cols={1}>
  <Card title="Collection de l'API Living Security v1" icon="download">
    Collection Postman v2.1 avec les `/v1` opérations et l'authentification Basic
    préconfigurée. Le champ `baseUrl` de la collection est vide : sélectionnez un
    environnement régional avant d'envoyer une requête.

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

  <Card title="Environnement de production (US)" icon="download">
    `baseUrl` prédéfini sur `https://api.us-east-1.livingsecurity.ai/v1`, avec
    les variables `apiKeySecret` et `contractVersion` vides à renseigner.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Télécharger l'environnement de production US</a>
  </Card>

  <Card title="Environnement de production (UE)" icon="download">
    `baseUrl` prédéfini sur `https://api.eu-west-1.livingsecurity.ai/v1`, avec
    les variables `apiKeySecret` et `contractVersion` vides à renseigner.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Télécharger l'environnement de production UE</a>
  </Card>

  <Card title="Modèle d'environnement" icon="download">
    Les mêmes variables avec un champ `baseUrl` vide, pour les configurations hors production.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Télécharger le modèle d'environnement</a>
  </Card>
</CardGroup>

## Configuration dans Postman

<Steps>
  <Step title="Importer les fichiers">
    Dans Postman, choisissez **Import** et déposez le fichier de la collection ainsi que
    l'environnement Production (US) ou Production (UE) correspondant à
    l'organisation. Consultez la page [Régions](/fr/developers/v1/regions).
  </Step>

  <Step title="Créer une clé d'API">
    Dans le Tableau de bord, ouvrez **Paramètres → Integrations & Developers →
    Developer Hub**, créez un compte de service, puis créez une clé d'API. Le secret de la clé commence par `lsk_live_` et
    n'est affiché qu'une seule fois : copiez-le immédiatement. Consultez les
    [clés d'API](/fr/developers/developer-hub/api-keys) pour plus de détails.
  </Step>

  <Step title="Coller le secret">
    Définissez la variable `apiKeySecret`, soit dans l'environnement importé
    (recommandé ; il s'agit d'une variable de type secret), soit dans l'onglet
    **Variables** de la collection.
  </Step>

  <Step title="Envoyer une requête">
    Sélectionnez l'environnement régional importé, ouvrez une requête quelconque (par exemple
    **Organization → Retrieve the organization**) et cliquez sur **Send**. N'envoyez
    rien tant qu'aucun environnement n'est sélectionné ; le champ `baseUrl` de la collection est vide
    volontairement.
  </Step>
</Steps>

## Fonctionnement de l'authentification préconfigurée

La collection définit l'authentification Basic au niveau de la collection, avec le nom d'utilisateur `apikey`
et le mot de passe `{{apiKeySecret}}`. L'API accepte le secret de la clé dans l'un ou l'autre des champs
de l'authentification Basic ; cela fonctionne donc tel quel une fois la variable définie.

Si vous préférez l'authentification par jeton Bearer, remplacez le type **Authorization** de la collection
par **Bearer Token** et utilisez `{{apiKeySecret}}` comme jeton : l'API
accepte le même secret dans les deux cas.

L'utilisation d'un en-tête Bearer avec une clé d'API ne nécessite pas OAuth. Pour utiliser OAuth,
définissez **Bearer Token** avec votre jeton d'accès OAuth au lieu du secret de la clé d'API.
Consultez [Authentification](/fr/developers/v1/authentication) pour choisir une méthode et
[Identifiants client OAuth](/fr/developers/v1/oauth) pour la configuration du jeton et du client.

## En-tête de version du contrat

Chaque requête comporte un en-tête `Living-Security-Version` prédéfini sur
`{{contractVersion}}`, désactivé par défaut. Laissez-le désactivé pour utiliser la version du contrat
figée pour votre organisation. Activez-le pour associer la requête à une
version publiée précise ; consultez le [journal des modifications](/fr/developers/v1/changelog)
pour connaître les versions publiées.

## Paramètres de requête et corps

Les filtres des points de terminaison de liste (`limit`, `page_token` et les filtres propres à chaque ressource)
sont inclus dans chaque requête mais désactivés, de sorte qu'une importation récente appelle chaque
point de terminaison avec succès. Activez et renseignez ceux dont vous avez besoin ; consultez
[Pagination](/fr/developers/v1/pagination) pour le fonctionnement de `page_token`. Les corps
de requête des opérations `POST` sont préremplis avec des valeurs fictives typées.

<Note>
  La collection est régénérée à partir de la spécification OpenAPI publiée à chaque
  modification du contrat : téléchargez une nouvelle copie plutôt que de modifier les requêtes que vous
  souhaitez conserver à jour.
</Note>


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