Skip to main content
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, 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 à vous connecter avec votre compte Living Security avant que le fichier ne soit fourni.

Collection de l'API Living Security v1

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.Télécharger la collection

Environnement de production (US)

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

Environnement de production (UE)

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

Modèle d'environnement

Les mêmes variables avec un champ 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 (US) ou Production (UE) correspondant à l’organisation. Consultez la page Régions.
2

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 pour plus de détails.
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 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.

​
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 pour choisir une méthode et Identifiants 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é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 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 pour 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 conserver à jour.