Die kostenlose KIWI REST API ermöglicht es Entwicklern, die digitalen Zutrittslösungen von KIWI nahtlos in eigene Anwendungen und Prozesse zu integrieren. Ob es um die Verwaltung von Zutrittsrechten oder das Öffnen von Türen geht – die API bietet die technologische Schnittstelle zur KIWI-Infrastruktur.
1. Voraussetzungen für die Nutzung
Um die API nutzen zu können, müssen Sie aktiver KIWI-Kunde sein. Hierfür gibt es zwei Wege:
Bestandskunden: Wenn Sie bereits eine KIWI-Installation und Zugang zum KIWI Portal haben, können Sie direkt starten.
Entwickler-Kit: Für Tests in einer sicheren Umgebung wird empfohlen, ein KIWI Developer Kit inklusive Testhardware anzufordern, um produktive Prozesse nicht zu stören.
2. Benutzerkonto und Zugriff
Die meisten Interaktionen mit der API erfordern ein Benutzerkonto. Dieses erhalten Sie entweder durch eine Einladung eines Administrators über das KIWI Portal oder durch Erstellung via API-Endpoints. Für die Integration empfiehlt es sich, ein Konto mit Administrator- oder Manager-Berechtigungen für die entsprechenden Sensoren (Türen/Tore) zu nutzen.
3. Erste Schritte: Authentifizierung
Bevor Anfragen an die API gesendet werden können, muss eine aktive Sitzung aufgebaut werden. Dies geschieht über den Endpoint POST /v1/session.
Vorgang: Sie senden Ihre Zugangsdaten (Benutzername und Passwort) an die API.
Ergebnis: Sie erhalten einen Session Key, der für alle folgenden API-Aufrufe zur Authentifizierung genutzt wird.
4. Dokumentation
Weitere Informationen gibt es auf unserer Webseite unter https://kiwi.ki/api-guideline/.
Die vollständige technische Dokumentation inklusive aller verfügbaren Endpoints und interaktiver Testmöglichkeiten finden Sie in der Swagger-UI unter: https://api.kiwi.ki/static/swagger/index.html
Hinweis: Sollten Sie Unterstützung bei der Einrichtung benötigen, steht der Support unter service@kiwi.ki zur Verfügung.