Gérer les droits d’accès
Utilisez les opérations /v1/access pour les identifiants. L’ouverture et la fermeture d’un appareil sont des opérations distinctes sous /v1/device.
POST
/v1/access/list
Lister les droits d’accès
Nécessite can_view_access_cards ou can_view_guests. Les restrictions du rôle et les filtres déterminent les droits visibles. Les résultats utilisent access_cards et count.
Corps de la requête JSON
| Paramètre | Type | Description |
|---|---|---|
| page | integer | Numéro de page; valeur par défaut : 1. |
| page_limit | integer | Résultats par page; valeur par défaut : 25. |
| search | string | Texte de recherche facultatif. |
Exemple de requête
curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/access/list" \
-H "SessionID: SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{"page":1,"page_limit":25}'
Exemple de réponse
Exemple sans droit d’accès correspondant.
{
"success": true,
"access_cards": [],
"count": 0
}
POST
/v1/access
Consulter un droit d’accès
Transmettez l’identifiant numérique du droit d’accès dans le corps JSON. Le compte doit être autorisé à consulter l’identifiant de l’utilisateur, du client ou de l’invité concerné.
Corps de la requête JSON
| Paramètre | Type | Description |
|---|---|---|
| id | integer | Identifiant du droit d’accès; remplacez la valeur d’exemple. |
Exemple de requête
curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/access" \
-H "SessionID: SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id":123}'
Créer, modifier et supprimer des identifiants
- PUT /v1/access crée un droit d’accès.
- PATCH /v1/access modifie un droit d’accès identifié par id.
- DELETE /v1/access supprime un droit d’accès identifié par id.
- Les écritures nécessitent la permission d’ajout, de modification ou de suppression correspondante pour les cartes d’accès ou les invités. Les champs dépendent du type d’identifiant et des entités associées.