Webhooks är det enklaste sättet att koppla externa auktorisations- och betalningsleverantörer till Zaptec-laddstationer. När en användare startar en laddsession skickar Zaptec en HTTP POST-förfrågan till din konfigurerade externa leverantör. Leverantören svarar antingen med att godkänna eller neka sessionen. Om den godkänns börjar laddningen — om inte, så gör den inte.
Detta ger dig ett säkert, flexibelt sätt att hantera både åtkomstkontroll och betalningar, utan tung infrastruktur.
För mer tekniska detaljer, kolla den officiella Zaptec Utvecklardokumentationen.
Integrationssteg
- Logga in på Zaptec-portalen.
- Gå till installationen som du hanterar med antingen ägar- eller tjänstbehörighet.
- Gå till Fliken för autentisering för din Installation. Här kan du välja mellan alternativa kommunikationsmetoder.
- Som standard är Zaptec Inbyggd autentisering aktiverad (behörigheter hanteras direkt i portalen).
- För att använda webhooks, välj Webhook-autentisering.
Webhooks konfigurationsparametrar
Autentiserings-URL
- Detta alternativ låter dig konfigurera URL:en för en OAuth-token-tjänst.
- Om det är inställt, kommer Zaptec först att hämta en OAuth-bearer-token från denna URL innan den skickar data till webhooken.
- Token ingår i Authorization huvudet för förfrågan:
Authorization: Bearer {access_token}Detta alternativ är obligatoriskt om webhook-anrop måste autentiseras med OAuth.
Autentiseringspayload
- Om en autentiserings-URL är konfigurerad, skickar Zaptec en förfrågan för att hämta en OAuth-token.
-
Payloaden måste matcha formatet som din OAuth-token-tjänst förväntar sig och skickas med innehållstyp:
application/x-www-form-urlencoded
-
Exempel på en vanlig OAuth-payload:
grant_type=password&username=AME&password={password} Om en autentiserings-URL inte anges, inkluderas användarnamnet och lösenordet från payloaden i Authorisation-huvudet med hjälp av HTTP Basic-autentisering.
-
För HTTP Basic-autentisering bör payloaden formateras som en frågesträng:
username=AME&password={password}
Sessionstart-URL
- Webhook-URL:en som Zaptec anropar innan en laddsession auktoriseras.
- Om den externa leverantören nekar förfrågan, kommer sessionen inte att starta.
Om ingen extern auktorisations-URL anges, kommer ZapClouds interna auktorisation att användas.
Sessionavslut-URL
Webhook-URL:en som Zaptec anropar efter att en laddsession avslutas (när fordonet kopplas bort från laddstationen).
Inaktivera auktorisation när laddstationer är offline
Om aktiverat, kommer laddstationer att tillåta laddning med vilken användare eller laddkort som helst när de tappar anslutningen till kontrollsystemet.
Denna konfiguration säkerställer sömlös integration mellan Zaptec och externa auktorisations- eller betalningsleverantörer, vilket ökar flexibiliteten och säkerheten.
Uppdaterad