Serviceanbieter registrieren
Ein Serviceanbieter ist eine Verleihorganisation, die Gemeingutartikel über eine Webplattform anbietet. Eine solche Webplattform ist über eine eindeutige Url (Link) erreichbar. Um mit der App auf die Angebote zugreifen zu können muss die Plattform die folgenden Voraussetzungen erfüllen:
- Die Plattform wird mit dem CommonsBooking Plugin betrieben
-
Für die Anzeige der Angebote:
die CommonsAPI (Bestandteil von CommonsBooking) ist aktiviert und frei zugänglich -
Für Buchen und Verwalten von Buchungen:
Eine Anmeldung an der Website und Installation des Plugins „API for CB App“.
Es gib zwei Möglichkeiten einen Serviceprovider für die App zu registrieren, über das Menü oder über den Einstellungen Dialog.
Option1: Serviceanbieter Dialog über Menü
Wählen sie hier den Menüpunkt „Service neu“, um die Dialogbox zum Erfassen der Daten des Serviceanbieters zu öffnen.
Option2: Serviceanbieterdialog über Einstellungen
Den Button „Neu“ unter „Service bearbeiten“ klicken , um die Dialogbox zum Erfassen der Daten des Serviceanbieters zu öffnen.
Daten des Serviceanbieters erfassen
01 – Link zur Webseite des Anbieters
02 – Verbindung testen
03 – Name der in der App für diesen Anbieter angezeigt wird
04 – Abbruch ohne Speichern der Eingaben
05 – Speichern der Servicedaten und weiter zu Account registrieren
Verbindung testen
Sie können die App testen lassen, ob die Url zum Serviceprovider erreichbar ist und welche Zugriffsmöglichkeiten (Schnittstellen) dieser unterstützt.
Geben sie dazu im „Service registrieren“ oder über die Einstellungen „Service bearbeiten“ die Url ein und tippen sie auf „Verbindung testen“ (02).
Beispiele für die Testergebnisse
Beispiel1: Alle Funktionen werden vom Serviceanbieter unterstützt
Netzwerkverbindung testen
Netzwerk verfügbar
Website Verbindungstest
Link Adresse erreichbar!
REST API Verbindungstest
Rest API Adresse erreichbar!
CommonsBooking API Test
CommonsBooking API vorhanden
Login Test
App Login aktiviert
App Extension API Test
App Extension API vorhanden!
Netzwerkverbindung testen
Ermittelt ob dieses Gerät Netzwerkverbindung hat
Website Verbindungstest
Ermittelt ob die Url über das Netzwerk erreichbar ist
REST API Verbindungstest
Ermittelt ob über der Serviceanbieter die WordPress REST API aktiviert hat
CommonsBooking API Test
Ermittelt ob der Serviceanbieter die CommonsAPI aktiviert hat
Login Test
Ermittelt ob bei dem Serviceanbieter das Login über ein Anwendungspasswort möglich ist
App Extension API Test
Ermittelt ob die Erweiterung für die CB App installiert und aktiviert ist
RESULTAT:
Die Informationen des Serviceanbieters können in der App angezeigt werden, falls ein Account vorhanden ist können Buchungen durchgeführt werden.
Beispiel2: Webseite erreichbar, CommonsBooking (API) verfügbar aber keine Extension API
Netzwerkverbindung testen
Netzwerk verfügbar
Website Verbindungstest
Link Adresse erreichbar!
REST API Verbindungstest
Rest API Adresse erreichbar!
CommonsBooking API Test
CommonsBooking API vorhanden
Login Test
App Login aktiviert
App Extension API Test
Fehler!
In diesem Beispiel ist die Webseite der Url erreichbar und hat auch die WordPress REST API und CommonsBooking inklusive API aktiviert. Die Extension API ist aber nicht verfügbar.
Dies ist z.B. bei einer WordPress Site mit CommonsBooking aber ohne App Unterstützung der Fall.
RESULTAT:
Die Informationen des Serviceanbieters können in der App angezeigt werden, Buchen ist nicht möglich.
Beispiel3: Webseite erreichbar, aber ohne CommonsBooking (API) und Extension API
Netzwerkverbindung testen
Netzwerk verfügbar
Website Verbindungstest
Link Adresse erreichbar!
REST API Verbindungstest
Rest API Adresse erreichbar!
CommonsBooking API Test
Fehler!
Login Test
App Login aktiviert
App Extension API Test
Fehler!
In diesem Beispiel ist die Webseite der Url erreichbar und hat auch die WordPress REST API aktiviert, aber es ist kein CommonsBooking installiert oder die API ist deaktiviert.
Dies ist z.B. bei einer WordPress Site ohne CommonsBooking (oder nicht aktivierter API) der Fall.
RESULTAT:
Die App kann für diese Site weder Informationen anzeigen noch ist Buchen möglich.
Beispiel4: Url fehlerhaft
Netzwerkverbindung testen
Netzwerk verfügbar
Website Verbindungstest
Bad Request
REST API Verbindungstest
FormatException: Unexpected character)
CommonsBooking API Test
Fehler!
Login Test
Fehler!
App Extension API Test
Fehler!
Zu der angegebenen Url kann keine Verbindung aufgebaut werden.
Dies ist z.B. bei einer fehlerhaften ode nicht existierenden Url der Fall.
RESULTAT:
Die App kann für diese Site weder Informationen anzeigen noch ist Buchen möglich.