Webhooks sind die einfachste Möglichkeit, externe Autorisierungs- und Zahlungsanbieter mit Zaptec-Ladestationen zu verbinden. Wenn ein Benutzer eine Ladesitzung startet, sendet Zaptec eine HTTP-POST-Anfrage an Ihren konfigurierten externen Anbieter. Der Anbieter antwortet entweder mit der Genehmigung oder Ablehnung der Sitzung. Wenn genehmigt, beginnt das Laden — wenn nicht, dann nicht.
Dies bietet Ihnen eine sichere, flexible Möglichkeit, sowohl den Zugangskontrolle als auch die Zahlungen zu verwalten, ohne umfangreiche Infrastruktur.
Für weitere technische Details überprüfen Sie die offizielle Zaptec Entwicklerdokumentation.
Integrationsschritte
- Melden Sie sich im Zaptec-Portal an.
- Gehen Sie zu der Installation, die Sie mit entweder Eigentümer- oder Serviceberechtigung verwalten.
- Gehen Sie zum Authentifizierungs-Tab Ihrer Installation. Hier können Sie zwischen alternativen Kommunikationsmethoden wählen.
- Standardmäßig ist die Zaptec Native-Authentifizierung aktiviert (Berechtigungen werden direkt im Portal verwaltet).
- Um Webhooks zu verwenden, wählen Sie Webhook-Authentifizierung.
Webhooks-Konfigurationsparameter
Authentifizierungs-URL
- Diese Option ermöglicht es Ihnen, die URL für einen OAuth-Token-Dienst zu konfigurieren.
- Wenn festgelegt, wird Zaptec zuerst ein OAuth-Bearer-Token von dieser URL abrufen, bevor Daten an den Webhook gesendet werden.
- Das Token ist im Authorization Header der Anfrage enthalten:
Authorization: Bearer {access_token}Diese Option ist erforderlich, wenn Webhook-Aufrufe mit OAuth authentifiziert werden müssen.
Authentifizierungspayload
- Wenn eine Authentifizierungs-URL konfiguriert ist, sendet Zaptec eine Anfrage, um ein OAuth-Token zu erhalten.
-
Das Payload muss dem erwarteten Format Ihres OAuth-Token-Dienstes entsprechen und wird mit dem Inhaltstyp:
application/x-www-form-urlencoded
-
Beispiel eines einfachen OAuth-Payloads:
grant_type=password&username=AME&password={password} Wenn keine Authentifizierungs-URL bereitgestellt wird, werden der Benutzername und das Passwort aus dem Payload im Autorisierungs-Header unter Verwendung der HTTP Basic-Authentifizierung enthalten.
-
Für die HTTP Basic-Authentifizierung sollte das Payload als Abfragezeichenfolge formatiert werden:
username=AME&password={password}
Sitzungsstart-URL
- Die Webhook-URL, die Zaptec aufruft, bevor eine Ladesitzung autorisiert wird.
- Wenn der externe Anbieter die Anfrage ablehnt, wird die Sitzung nicht gestartet.
Wenn keine externe Autorisierungs-URL bereitgestellt wird, wird die interne Autorisierung von ZapCloud verwendet.
Sitzungsende-URL
Die Webhook-URL, die Zaptec nach dem Ende einer Ladesitzung aufruft (wenn das Fahrzeug von der Ladestation getrennt wird).
Autorisierung deaktivieren, wenn Ladestationen offline sind
Wenn aktiviert, erlauben Ladestationen das Laden mit jedem Benutzer oder Ladekarte, wenn sie die Verbindung zum Kontrollsystem verlieren.
Dieses Setup gewährleistet eine nahtlose Integration zwischen Zaptec und externen Autorisierungs- oder Zahlungsanbietern und verbessert die Flexibilität und Sicherheit.
Aktualisiert