Skip to main content
La collection Postman de l’API v1 de Living Security 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; 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

Les liens de téléchargement vous invitent à ouvrir une session avec votre compte Living Security avant que le fichier ne soit fourni.

Collection de l'API v1 de Living Security

Collection Postman v2.1 avec les /v1 opérations et l’authentification Basic préconfigurée. La collection baseUrl est vide : sélectionnez un environnement régional avant d’envoyer une requête.Télécharger la collection

Environnement de production (É.-U.)

baseUrl préconfiguré sur https://api.us-east-1.livingsecurity.ai/v1, avec les variables apiKeySecret et contractVersion vides à renseigner.Télécharger l’environnement de production des États-Unis

Environnement de production (UE)

baseUrl préconfiguré sur https://api.eu-west-1.livingsecurity.ai/v1, avec les variables apiKeySecret et contractVersion vides à renseigner.Télécharger l’environnement de production de l’UE

Modèle d'environnement

Les mêmes variables avec un baseUrl vide, pour les configurations hors production.Télécharger le modèle d’environnement

​
Configuration dans Postman

1

Importer les fichiers

Dans Postman, choisissez Import et déposez le fichier de la collection ainsi que l’environnement Production (É.-U.) ou Production (UE) qui correspond à l’organisation. Consultez la section Régions.
2

Créer une clé API

Dans le Tableau de bord, ouvrez Paramètres → Intégrations & Developers → Developer Hub, créez un compte de service, puis créez une clé API. Le secret de la clé commence par lsk_live_ et n’est affiché qu’une seule fois : copiez-le immédiatement. Consultez la section Clés API pour en savoir plus.
3

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

Envoyer une requête

Sélectionnez l’environnement régional importé, ouvrez n’importe quelle requête (par exemple Organisation → Retrieve the organization) et cliquez sur Envoyer. N’envoyez rien tant qu’aucun environnement n’est sélectionné : la variable baseUrl de la collection est vide volontairement.

​
Préconfiguration de l’authentification

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 porteur, changez le type d’Authorization de la collection pour 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é API ne nécessite pas OAuth. Pour utiliser OAuth, définissez Bearer Token avec votre jeton d’accès OAuth plutôt qu’avec le secret de la clé API. Consultez la section Authentification pour choisir une méthode et Informations d’identification du client 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éconfiguré sur {{contractVersion}}, désactivé par défaut. Laissez-le désactivé pour utiliser la version du contrat épinglée pour votre organisation. Activez-le pour épingler la requête à une version publiée précise; consultez le journal des modifications 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 la section Pagination pour comprendre le fonctionnement de page_token. Les corps de requête des opérations POST sont préremplis avec des valeurs fictives typées.
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 garder à jour.