Webhooks er den enkleste måten å koble eksterne autorisasjons- og betalingsleverandører til Zaptec ladestasjoner. Når en bruker starter en ladingsøkt, sender Zaptec en HTTP POST-forespørsel til din konfigurerte eksterne leverandør. Leverandøren svarer med enten å godkjenne eller avslå sesjonen. Hvis den godkjennes, begynner ladingen — hvis ikke, så gjør den ikke det.
Dette gir deg en sikker, fleksibel måte å håndtere både tilgangskontroll og betalinger på, uten tung infrastruktur.
For mer tekniske detaljer, sjekk den offisielle Zaptec utviklerdokumentasjonen.
Integrasjonstrinn
- Logg inn på Zaptec-portalen.
- Gå til installasjonen du administrerer med enten eier- eller tjenestetillatelser.
- Gå til Autentisering-fanen til din Installasjon. Her kan du velge mellom alternative kommunikasjonsmetoder.
- Som standard er Zaptec Native autentisering aktivert (tillatelser administrert direkte i portalen).
- For å bruke webhooks, velg Webhook-autentisering.
Webhooks konfigurasjonsparametere
Autentisering URL
- Dette alternativet lar deg konfigurere URL-en for en OAuth-token-tjeneste.
- Hvis det er angitt, vil Zaptec først skaffe seg et OAuth-bærer-token fra denne URL-en før den sender data til webhooken.
- Tokenet er inkludert i Authorization headeren til forespørselen:
Authorization: Bearer {access_token}Dette alternativet er påkrevd hvis webhook-anrop må autentiseres ved hjelp av OAuth.
Autentisering belastning
- Hvis en Autentisering URL er konfigurert, sender Zaptec en forespørsel for å skaffe seg et OAuth-token.
-
Belastningen må samsvare med formatet som forventes av din OAuth-token-tjeneste og sendes med innholdstypen:
application/x-www-form-urlencoded
-
Eksempel på en vanlig OAuth-belastning:
grant_type=password&username=AME&password={password} Hvis en Autentisering URL ikke er oppgitt, inkluderes brukernavnet og passordet fra belastningen i Autorisasjonsheaderen ved hjelp av HTTP Basic-autentisering.
-
For HTTP Basic-autentisering bør belastningen formateres som en spørringsstreng:
username=AME&password={password}
Sesjon start URL
- Webhook-URL-en som Zaptec kaller før autorisering av en ladingsøkt.
- Hvis den eksterne leverandøren avslår forespørselen, vil ikke sesjonen starte.
Hvis ingen ekstern autoriserings-URL er oppgitt, vil ZapClouds interne autorisering bli brukt.
Sesjon slutt URL
Webhook-URL-en som Zaptec kaller etter at en ladingsøkt er avsluttet (når kjøretøyet er frakoblet ladestasjonen).
Deaktiver autorisasjon når ladestasjoner er offline
Hvis aktivert, vil ladestasjoner tillate lading med hvilken som helst bruker eller ladebrikke når de mister tilkoblingen til kontrollsystemet.
Dette oppsettet sikrer sømløs integrasjon mellom Zaptec og eksterne autorisasjons- eller betalingsleverandører, og forbedrer fleksibilitet og sikkerhet.
Oppdatert