Webhooks zijn de eenvoudigste manier om externe autorisatie- en betalingsproviders te verbinden met Zaptec laadstations. Wanneer een gebruiker een laad sessie start, stuurt Zaptec een HTTP POST-verzoek naar uw geconfigureerde externe provider. De provider reageert door de sessie goed te keuren of te weigeren. Als het is goedgekeurd, begint het opladen - zo niet, dan gebeurt dat niet.
Dit biedt u een veilige, flexibele manier om zowel toegangscontrole als betalingen te beheren, zonder zware infrastructuur.
Voor meer technische details kunt u de officiële Zaptec Developer Documentation. raadplegen.
Integratiestappen
- Log in op het Zaptec Portal.
- Ga naar de installatie die u beheert met eigenaar- of servicebevoegdheid.
- Ga naar het Authenticatietabblad van uw Installatie. Hier kunt u kiezen tussen alternatieve communicatiemethoden.
- Standaard is Zaptec Native authenticatie ingeschakeld (machtigingen worden rechtstreeks in het portaal beheerd).
- Om webhooks te gebruiken, selecteert u Webhook-authenticatie.
Webhooks configuratieparameters
Authenticatie-URL
- Deze optie stelt u in staat om de URL voor een OAuth-tokenservice te configureren.
- Als ingesteld, zal Zaptec eerst een OAuth-bearer-token van deze URL verkrijgen voordat gegevens naar de webhook worden verzonden.
- Het token is opgenomen in de Authorization header van het verzoek:
Authorization: Bearer {access_token}Deze optie is vereist als webhook-aanroepen moeten worden geverifieerd met OAuth.
Authenticatiepayload
- Als er een Authenticatie-URL is geconfigureerd, stuurt Zaptec een verzoek om een OAuth-token te verkrijgen.
-
De payload moet overeenkomen met het verwachte formaat van uw OAuth-tokenservice en wordt gepost met het contenttype:
application/x-www-form-urlencoded
-
Voorbeeld van een eenvoudige OAuth-payload:
grant_type=password&username=AME&password={password} Als er geen Authenticatie-URL is opgegeven, worden de gebruikersnaam en het wachtwoord uit de payload opgenomen in de Autorisatie-header met behulp van HTTP Basic-authenticatie.
-
Voor HTTP Basic-authenticatie moet de payload worden opgemaakt als een querystring:
username=AME&password={password}
Sessiestart-URL
- De webhook-URL die Zaptec aanroept voordat een laad sessie wordt geautoriseerd.
- Als de externe provider het verzoek weigert, zal de sessie niet starten.
Als er geen externe autorisatie-URL wordt opgegeven, wordt de interne autorisatie van ZapCloud gebruikt.
Einde sessie-URL
De webhook-URL die Zaptec aanroept nadat een laad sessie is beëindigd (wanneer het voertuig is losgekoppeld van het laadstation).
Deactiveer autorisatie wanneer laadstations offline zijn
Als ingeschakeld, zullen laadstations opladen met elke gebruiker of laadpas toestaan wanneer ze de verbinding met het besturingssysteem verliezen.
Deze opstelling zorgt voor een naadloze integratie tussen Zaptec en externe autorisatie- of betalingsproviders, waardoor flexibiliteit en veiligheid worden verbeterd.
Bijgewerkt