# Gérer les portes via l’API

Les plateformes tierces peuvent contrôler de manière programmatique les portes gérées par Verkada avec le **Activer la gestion des portes via l’API** paramètre activé en utilisant l’API de contrôle d’accès de Verkada.

### APIs applicables à la gestion des portes

Les catégories d’API de contrôle d’accès suivantes incluent des APIs qui exigent que toutes les portes contrôlées avec l’API aient **Activer la gestion des portes via l’API** activé.

* [APIs d’ouverture de porte par accès](https://apidocs.verkada.com/reference/postaccessadminapiunlockviewv1)
* [APIs de calendrier d’exception de porte](https://apidocs.verkada.com/reference/getaccessdoorexceptioncalendarsviewv1)
* [APIs de niveaux d’accès](https://apidocs.verkada.com/reference/getaccesslevelview)

{% hint style="warning" %}
Voir [Docs API Verkada](https://apidocs.verkada.com/) pour des détails sur les points de terminaison API spécifiques qui exigent ce paramètre.
{% endhint %}

***

## Configuration de Command

Avant qu’une porte puisse être contrôlée via l’API, les autorisations pour contrôler la porte via l’API doivent être activées aux niveaux suivants :

* [Niveau organisation](https://help.verkada.com/access-control/fr/integrations-et-alertes/manage-doors-via-api)
* [Niveau du site](https://help.verkada.com/access-control/fr/integrations-et-alertes/manage-doors-via-api)
* [Niveau de la porte](https://help.verkada.com/access-control/fr/integrations-et-alertes/manage-doors-via-api)

### Configuration au niveau de l’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 la gestion des portes via l’API.**
{% endstep %}
{% endstepper %}

### Configuration au niveau du site

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

{% step %}
**Dans le menu déroulant All Sites, sélectionnez un site.**
{% endstep %}

{% step %}
**En haut, cliquez sur Paramètres d’accès .**
{% endstep %}

{% step %}
**Activez Activer la gestion des portes via l’API.**
{% endstep %}
{% endstepper %}

### Configuration au niveau de la porte

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

{% step %}
**Dans le menu déroulant All Sites, sélectionnez un site.**
{% endstep %}

{% step %}
**Sélectionnez une porte et cliquez sur Paramètres .**
{% endstep %}

{% step %}
**Sous Paramètres de l’installateur, activez Activer la gestion des portes via l’API.**
{% endstep %}
{% endstepper %}

***

## Examen des événements d’ouverture via l’API

Lorsqu’un appel d’API d’ouverture de porte est utilisé, un événement est enregistré dans Command indiquant qu’une demande d’ouverture de porte via l’API a été effectuée. L’événement indiquera si l’accès a été accordé, quelle API a été utilisée et (le cas échéant) un utilisateur d’accès associé à la demande.

Les événements associés à une demande d’ouverture de porte via l’API peuvent être consultés dans le [Rapports](https://help.verkada.com/access-control/fr/integrations-et-alertes/access-control-reports) page ou sur la [page de la porte](https://help.verkada.com/access-control/fr/configuration/configure-a-door-in-command/view-access-control-doors) pour la porte concernée.

Les événements associés aux demandes d’ouverture de porte via l’API incluent les informations suivantes :

* **Nom de l’événement :** Accès accordé ou Accès refusé
* **Méthode :** API d’ouverture utilisateur ou API d’ouverture administrateur
* **Utilisateur** (si la méthode est API d’ouverture utilisateur) : Utilisateur d’accès associé à la demande d’ouverture.
* **Identifiant :** Nom de la [clé API Verkada](https://apidocs.verkada.com/reference/quick-start-guide) utilisée pour effectuer la demande d’ouverture via l’API.

![](https://1006431132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2Fgit-blob-cf0634a515298f6859d83b4003fdfe66e7be1d0f%2F7a19b9a1125e6501a1d598feac3e3287d32a2029.png?alt=media)

***

{% hint style="info" %}
**Vous préférez le voir en action ?** Consultez le [tutoriel vidéo](https://www.youtube.com/watch?v=nvJkh2jyOjU).
{% endhint %}