CommonsBooking API nutzen

__

Dieser Artikel erklärt wie du die CommonsBooking-API nutzen kannst. Aber was ist die CommonsBooking API)?

CommonsBooking verfügt über eine eigene API, über diese ihr bequem via Webschnittstelle auf Daten des Plugins zugreifen könnt oder die Daten für andere Plattformen und Dienste zur Verfügung stellt. Die API basiert auf der in WordPress implementierten REST-API.

Aktivierung der API

Die API ist standardmäßig deaktiviert und es gibt keine Verbindungen zu externen Services oder Plattformen. Die API aktivierst du über die Einstellungen (s.u.) und die Checkbox "API aktivieren".

Einstellungen allgemein

Die API erreichst du über Einstellungen -> CommonsBooking -> Tab: API / Export.

• API aktivieren: Aktiviert generell den API-Zugriff
• API Zugang ohne API-Schlüssel: Wenn diese Option aktiviert ist, kann auf die API auch ohne einen individuellen API-Key zugegriffen werden. Diese Einstellung ist sinnvoll, wenn ihre eure Daten mit mehreren Plattformen teilen möchtet.
• API-Freigaben: Die Schnittstelle kann für verschiedene Endpunkte bzw. anfragende Seiten freigegeben werden. Um die Zugriffsrechte entsprechend zu steuern könnt ihr auch mehrere unterschiedliche Freigaben anlegen.

Einstellungen pro API-Freigabe

• Schnittstellen-Name: Ein beliebiger Name für eure interne Bezeichnung der API
• Schnittstelle aktiviert: Die API-Freigabe ist erst aktiviert, wenn diese Häkchen gesetzt ist.
• Push-URL: Hier könnt ihr die URL des empfangenden Systems eingeben. CommonsBooking wird diese URL bei jeder Änderung der Daten aufrufen, sodass das entfernte System dann über eine Änderung der Daten informiert und diese über einen separaten API-Call abrufen kann. So kann ein Datenaustausch in Echtzeit ermöglicht werden.
• API-Schlüssel: Hier könnt ihr einen selbstgewählten API-Schlüssel eingeben. Wenn der Schlüssel gesetzt ist, muss das abfragende System in jeder Abfrage den Parameter apikey= [Schlüssel] mitliefern.

Spezifikation der API-Routen

Verfügbarkeit

• Beschreibung: Zeit die Verfügbarkeiten von Artikel an Standorten an
• Route: /wp-json/commonsbooking/v1/availability
• Schema: https://github.com/wielebenwir/commons-api/blob/master/commons-api.availability.schema.json

Items / Artikel

• Beschreibung: Gibt Daten zu allen veröffentlichen Artikeln inklusive der damit verknüpften Verfügbarkeiten und Standorte zurück
• Route: /wp-json/commonsbooking/v1/items
• Schema: https://github.com/wielebenwir/commons-api/blob/master/commons-api.items.schema.json

Locations / Standorte

• Beschreibung: Gibt eine Liste aller Standorte zurück inklusive der Geo-Koordinaten
• Route: wp-json/commonsbooking/v1/locations
• Schema: https://github.com/wielebenwir/commons-api/blob/master/commons-api.locations.schema.json

Projekte / Projects

• Beschreibung: Gibt die Basisdaten der WordPress-Instanz zurück
• Route: wp-json/commonsbooking/v1/projects
• Schema: https://github.com/wielebenwir/commons-api/blob/master/commons-api.projects.schema.json