# Gérer les verrouillages via l’API

## Scénarios

Dans l’API, les verrouillages sont représentés comme des scénarios. Chaque scénario inclut un `type` champ qui définit son objectif. Vous pouvez gérer programmatiquement les scénarios Verkada, par exemple lister les verrouillages disponibles, en activer un ou relâcher un scénario actif, en utilisant des plateformes tierces et des outils d’automatisation.

***

## Configuration de Command

#### Niveau organisation

{% stepper %}
{% step %}
**Dans Verkada Command, allez dans Tous les produits > Accès.**
{% endstep %}

{% step %}
**Dans la navigation de gauche, cliquez sur Paramètres d’accès.**
{% endstep %}

{% step %}
**Activez Activer le verrouillage et le contrôle des scénarios via l’API.**
{% endstep %}
{% endstepper %}

#### Générer une clé API

{% stepper %}
{% step %}
**Dans Verkada Command, allez dans Tous les produits > Admin.**
{% endstep %}

{% step %}
**Sous Paramètres de l’organisation, cliquez sur API & Intégrations.**
{% endstep %}

{% step %}
**Depuis les paramètres API & Intégrations, sélectionnez Clés API > Ajouter.**

a. Sélectionnez **Nouvelle clé** et cliquez **Suivant.**\
b. Entrez un nom unique.\
c. Sous **Points de terminaison**, sélectionnez **Contrôle d’accès.**\
d. Définissez les autorisations sur **Lecture/Écriture**.\
e. Définissez la date d’expiration.\
f. Cliquez **Générer l’API.**
{% endstep %}
{% endstepper %}

***

## Actions API disponibles

Une fois que vous avez configuré Command pour autoriser le contrôle des scénarios via l’API, vous pouvez effectuer les actions suivantes :

* [Lister les scénarios](https://apidocs.verkada.com/reference/getaccessscenariolistviewv1) : Récupérer tous les scénarios configurés dans votre organisation.
* [Activer un scénario](https://apidocs.verkada.com/reference/postaccessscenarioactivateviewv1) : Déclencher un scénario de façon programmatique en réponse à un événement ou une condition.
* [Relâcher un scénario](https://apidocs.verkada.com/reference/postaccessscenarioreleaseviewv1) : Mettre fin à ou désactiver un scénario actif.

{% hint style="warning" %}
Voir [Docs API Verkada](https://apidocs.verkada.com/reference/access-scenarios) pour plus de détails sur des points de terminaison spécifiques de l’API de contrôle d’accès.
{% endhint %}

***

## Activer et relâcher un scénario via l’API

Lorsqu’un scénario tel qu’un verrouillage est activé ou relâché via l’API, il se comporte de la même manière que s’il avait été déclenché manuellement dans Command.

L’utilisation de l’API pour activer ou relâcher un scénario va :

* Exécuter toutes les actions configurées du scénario, telles que verrouiller des portes, déclencher des alertes ou activer des sorties AUX.
* Mettre à jour le statut du scénario à la fois dans l’interface Command et dans l’application Verkada Pass.
* Générer des journaux d’événements pour chaque action, visibles dans le rapport Événements et le journal d’audit de Command.