Das System Hut Reservation ist so konzipiert, dass die einzelnen Hütten in Drittsysteme wie z.B. Tourenportale, Webkartenapplikationen, Apps aber auch auf den Hütten- oder Sektionswebseiten integriert und von dort aufgerufen werden können.
Es gibt 3 Optionen, wie man die Reservierungsseite der Hütte für Gäste, auch Wizard genannt, von außen erreichen kann:
Außerdem gibt es eine REST Schnittstelle (API), die es erlaubt Reservierungen durch externe Systeme anzulegen, zu ändern sowie stornieren. Zusätzlich können Basisdaten der Hütte und die Liste der Reservierungen abgefragt werden.
Die häufigste Nutzung der API ist jedoch die Abfrage der Verfügbarkeit der freien Plätze in den Hütten für eine bestimmte Anzahl Personen an einem bestimmten Datum.
Die API ist durch eine Swagger Dokumentation bestens dokumentiert. Damit die API genutzt werden kann, muss durch den Administrator ein API Key generiert und dem Drittanbieter bereitgestellt werden.
Bitte kontaktiere uns direkt für weitere Details und Link zur Swagger Dokumentation. Wir behalten uns jedoch vor, die Integration abzulehnen. Unser Ziel ist es nur einen kleinen Kreis an ausgewählten externen Integrationen zu unterstützen. Sonst kann der Aufwand für Integration bzw. Support unsere limitierte Kapazität übersteigen. Für die Integration werden aktuell keine Gebühren erhoben.
Damit der Gast im ersten Schritt des Wizards gelangt muss folgender Link aufgerufen werden:
*https://www.hut-reservation.org/reservation/book-hut/{hut_id}/wizard*
Wobei die <hut_id> die Nummer der Hütte darstellt. Diese kann aus der Konfiguration der Hütte aus dem Reiter „Allgemein“ übernommen werden.
Ein Beispiel: https://www.hut-reservation.org/reservation/book-hut/1/wizard
Die Sprache voreinzustellen ist nicht vorgesehen. Die Sprache wird durch die Browser Sprache bzw. im eingeloggten Zustand durch die Sprache des Users gesteuert.
Diese Art der Integration ist gut für die Sektionsseiten geeignet, die ihre Hütten beschreiben und einen direkten Weg zur Reservierungsseite für Gäste im Hut Reservation bereitstellen wollen.
Ein funktionierendes Beispiel ist auf der Webseite: https://www.hut-reservation.org/static/ui-widgets/calltoaction/test-widget/test-call-to-action.html abgebildet.