Webhooks er den enkleste måde at forbinde eksterne autorisations- og betalingsudbydere til Zaptec ladestationer. Når en bruger starter en ladningssession, sender Zaptec en HTTP POST-anmodning til din konfigurerede eksterne udbyder. Udbyderen svarer ved enten at godkende eller afvise sessionen. Hvis den godkendes, begynder opladningen - hvis ikke, gør den ikke.
Dette giver dig en sikker, fleksibel måde at administrere både adgangskontrol og betalinger på, uden tung infrastruktur.
For flere tekniske detaljer, se den officielle Zaptec udviklerdokumentation.
Integrations trin
- Log ind på Zaptec Portalen.
- Gå til den installation, du administrerer med enten ejer- eller serviceadgang.
- Gå til fanen Authentication for din Installation. Her kan du vælge mellem alternative kommunikationsmetoder.
- Som standard er Zaptec Native authentication aktiveret (tilladelser administreres direkte i portalen).
- For at bruge webhooks, vælg Webhook authentication.
Webhooks konfigurationsparametre
Autentificerings-URL
- Denne mulighed giver dig mulighed for at konfigurere URL'en for en OAuth token service.
- Hvis den er indstillet, vil Zaptec først hente en OAuth bearer token fra denne URL, før den sender data til webhooken.
- Tokenet er inkluderet i Authorization headeren af anmodningen:
Authorization: Bearer {access_token}Denne mulighed er påkrævet, hvis webhook-anmodninger skal autentificeres ved hjælp af OAuth.
Autentificeringspayload
- Hvis en autentificerings-URL er konfigureret, sender Zaptec en anmodning for at hente en OAuth token.
-
Payloaden skal matche det forventede format fra din OAuth token service og sendes med indholdstypen:
application/x-www-form-urlencoded
-
Eksempel på en simpel OAuth payload:
grant_type=password&username=AME&password={password} Hvis en autentificerings-URL ikke er angivet, inkluderes brugernavnet og adgangskoden fra payloaden i Authorisation headeren ved hjælp af HTTP Basic authentication.
-
For HTTP Basic authentication skal payloaden formateres som en forespørgselsstreng:
username=AME&password={password}
Session start URL
- Webhook-URL'en, som Zaptec kalder, før den godkender en ladningssession.
- Hvis den eksterne udbyder afviser anmodningen, vil sessionen ikke starte.
Hvis ingen ekstern autorisations-URL er angivet, vil ZapClouds interne autorisation blive brugt.
Session slut URL
Webhook-URL'en, som Zaptec kalder, efter en ladningssession slutter (når køretøjet er frakoblet ladestationen).
Deaktiver autorisation, når ladestationer er offline
Hvis aktiveret, vil ladestationer tillade opladning med enhver bruger eller ladekort, når de mister forbindelsen til kontrolsystemet.
Denne opsætning sikrer problemfri integration mellem Zaptec og eksterne autorisations- eller betalingsudbydere, hvilket øger fleksibiliteten og sikkerheden.
Opdateret