Eine eigens gebaute Website über die Website-API anbinden

Vorher nötig

• Die Rolle Leitung
• Eine Agentur oder ein Entwickler, der Ihre Website baut. Die API ist für deren Programm gedacht, nicht zum Lesen im Browser.

Einen Zugang anlegen

1. 1

   Öffnen Sie Einrichtung › Verbindungen › Website-API (JSON).

2. 2

   Geben Sie unter Neuer Zugang einen Namen ein und klicken Sie auf Anlegen.

   Nehmen Sie den Namen der Website oder der Agentur. Legen Sie je Website einen eigenen Zugang an, dann trifft ein Widerruf nur diese eine Anbindung.

3. 3

   Kopieren Sie beim neuen Zugang die Marke und geben Sie sie Ihrer Agentur.

   Die Marke ist der Schlüssel. Schicken Sie sie auf einem sicheren Weg, nicht in einem öffentlichen Ticket.

4. 4

   Schicken Sie die Adressen der Endpunkte mit.

   Sie stehen unter Endpunkte & Dokumentation, dazu eine Beispiel-Anfrage. Darin steht die Marke nur als Platzhalter, Sie können den Text also weitergeben.

Was die Website bekommt

Fünf Endpunkte, alle nur lesend:

• Hotel-Profil: Name, Anschrift, Kontakt, Beschreibung, Bilder, Hausregeln, Ausstattung und Stornoregel
• Zimmer: die Zimmertypen mit Texten, Fotos, Größe, Betten und Ausstattung
• Zusatzleistungen: mit Preis und Berechnungsart
• Preislisten: mit Saisonzeiträumen und Preisen je Zimmertyp
• Verfügbarkeit: freie Zimmer je Zimmertyp und Nacht, bis zu 400 Nächte auf einmal

Texte kommen in allen Sprachen, die Sie gepflegt haben. Die Website wählt selbst, welche sie zeigt. Versteckte Zimmertypen liefert die API nirgends mit.

Gebucht wird über die API nicht. Dafür bauen Sie das Das Buchungswidget auf der Website einbauen in die Website ein.

Was Ihre Agentur wissen muss

• Die Marke gehört in den Header jeder Anfrage: Authorization: Bearer <Marke>. In der Adresse hat sie nichts verloren.
• Am besten ruft der Server oder der Build der Website die Daten ab. In Browser-Code sieht jeder Besucher die Marke.
• Beträge kommen als ganze Cent. Die Währung steht im Hotel-Profil.
• Bestehende Felder ändern sich nicht. Neues kommt nur dazu.

Was dann passiert

Ändern Sie in HANS einen Preis, ein Foto oder die Verfügbarkeit, bekommt die Website den neuen Stand beim nächsten Abruf. Wann sie abruft, legt die Agentur fest.

Neben jedem Zugang steht, wann er zuletzt abgerufen wurde. Steht dort noch nicht abgerufen, hat die Website noch keine gültige Anfrage geschickt.

Wenn es nicht klappt