Webhooks
Configurez des webhooks pour recevoir des notifications en temps réel lorsque des événements se produisent dans votre système LEXOH.
/api/v1/webhooks
Créez un nouveau point de terminaison webhook.
Exemple de requête
curl -X POST "https://api.lexoh.com/v1/webhooks" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-server.com/webhook", "events": ["access.granted", "device.connected"], "secret": "your_webhook_secret" }'
Charge utile du webhook
Lorsqu'un événement se produit, LEXOH envoie une requête POST à votre URL webhook avec la charge utile suivante:
{ "id": "evt_12345", "type": "access.granted", "timestamp": "2024-01-15T10:30:00Z", "data": { "device_id": "device_456", "user_id": "user_123", "location": "Main Entrance" } }
Sécurité du webhook
Chaque charge utile de webhook inclut un en-tête X-LEXOH-Signature contenant une signature HMAC SHA-256. Vérifiez cette signature pour vous assurer que le webhook provient de LEXOH.
// Python example import hmac import hashlib def verify_webhook(payload, signature, secret): computed = hmac.new( secret.encode(), payload.encode(), hashlib.sha256 ).hexdigest() return hmac.compare_digest(computed, signature)
Événements disponibles
Types d'événements webhook:
device.connected- L'appareil se connectedevice.disconnected- L'appareil se déconnecteaccess.granted- Permission d'accès accordéeaccess.denied- Permission d'accès refuséealert.triggered- Alerte de sécurité déclenchée
/api/v1/webhooks
Listez tous les webhooks configurés.
/api/v1/webhooks/{id}
Supprimez une configuration de webhook.
🎉 Vous avez terminé la référence de l'API!
Commencez à créer des intégrations incroyables avec la plateforme LEXOH
