Les Webhooks sont le moyen le plus simple de connecter des fournisseurs d'autorisation et de paiement externes aux stations de charge Zaptec. Lorsqu'un utilisateur démarre une session de charge, Zaptec envoie une requête HTTP POST à votre fournisseur externe configuré. Le fournisseur répond en approuvant ou en refusant la session. Si approuvé, la charge commence - sinon, elle ne commence pas.
Cela vous offre un moyen sécurisé et flexible de gérer à la fois le contrôle d'accès et les paiements, sans infrastructure lourde.
Pour plus de détails techniques, consultez la documentation officielle des développeurs Zaptec.
Étapes d'intégration
- Connectez-vous au portail Zaptec.
- Accédez à l'installation que vous gérez avec soit les droits de propriétaire, soit les droits de service.
- Allez dans l'onglet Authentification de votre Installation. C'est ici que vous pouvez choisir entre différentes méthodes de communication.
- Par défaut, Zaptec L'authentification native est activée (les autorisations sont gérées directement dans le portail).
- Pour utiliser les webhooks, sélectionnez L'authentification par webhook.
Paramètres de configuration des webhooks
URL d'authentification
- Cette option vous permet de configurer l'URL pour un service de jeton OAuth.
- Si configuré, Zaptec obtiendra d'abord un jeton d'accès OAuth à partir de cette URL avant d'envoyer des données au webhook.
- Le jeton est inclus dans l'en-tête Authorization de la requête :
Authorization: Bearer {access_token}Cette option est requise si les appels de webhook doivent être authentifiés à l'aide d'OAuth.
Charge utile d'authentification
- Si une URL d'authentification est configurée, Zaptec envoie une requête pour obtenir un jeton OAuth.
-
La charge utile doit correspondre au format attendu de votre service de jeton OAuth et est postée avec le type de contenu :
application/x-www-form-urlencoded
-
Exemple d'une charge utile OAuth simple :
grant_type=password&username=AME&password={password} Si une URL d'authentification n'est pas fournie, le nom d'utilisateur et le mot de passe de la charge utile sont inclus dans l'en-tête d'autorisation à l'aide de l'authentification HTTP Basic.
-
Pour l'authentification HTTP Basic, la charge utile doit être formatée comme une chaîne de requête :
username=AME&password={password}
URL de début de session
- L'URL du webhook que Zaptec appelle avant d'autoriser une session de charge.
- Si le fournisseur externe refuse la demande, la session ne commencera pas.
Si aucune URL d'autorisation externe n'est fournie, l'autorisation interne de ZapCloud sera utilisée.
URL de fin de session
L'URL du webhook que Zaptec appelle après la fin d'une session de charge (lorsque le véhicule est déconnecté de la station de charge).
Désactiver l'autorisation lorsque les stations de charge sont hors ligne
Si activé, les stations de charge permettront la charge avec n'importe quel utilisateur ou carte de charge lorsqu'elles perdent la connexion au système de contrôle.
Cette configuration garantit une intégration transparente entre Zaptec et les fournisseurs d'autorisation ou de paiement externes, améliorant la flexibilité et la sécurité.
Mise à jour