EntwicklerportalHMS Hotelsoftware

Verbinden Sie Ihre Software mit den HMS-Modulen

Eine eigene API-Dokumentation für jedes Modul der Hotelsoftware: Buchungsmaschine, Gäste-WLAN, Restaurant-POS, Spa, TV, Telefonanlage und KI-Dienste. Die APIs für Online Booking und Hotspot sind bereits verfügbar; die übrigen folgen.

Authentifizierung
Bearer-Token oder ApiKey-Header
Format
JSON-Antworten mit success-Envelope
Verfügbar
2 Produkte · 17 Endpunkte
In Vorbereitung
5 Produkte
Anfrage
# Zimmer- und Preisabfrage
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Antwort · 200 (gekürzt)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Standardzimmer",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Übernachtung mit Frühstück",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Produkte

Jedes Produkt hat eine eigene Dokumentation, API-Referenz und Codebeispiele. Neue Produkte werden bei ihrer Veröffentlichung in den Versionshinweisen angekündigt.

Verfügbar

Online Booking

API für Buchungsmaschinen

Verbindet die Buchungsmaschine auf der Website des Hotels mit HMS: Zimmer- und Preisliste, Verfügbarkeitskalender, Gutscheine, Zahlung und Buchungsübermittlung.

8 Ressourcen · 16 EndpunkteDokumentation
Verfügbar

Hotspot

Gäste-WLAN und Protokollierung nach Gesetz Nr. 5651

Stellt dem Hotspot-System die Liste der Gäste im Haus bereit: Zimmer, Identität, Check-in- und Check-out-Zeiten. Zur Prüfung von WLAN-Anmeldungen anhand der Zimmernummer und zur Führung der Zugriffsprotokolle nach dem türkischen Gesetz Nr. 5651.

1 Ressource · 1 EndpunktDokumentation
In Vorbereitung

Restaurant-POS

Rechnungen und Zimmerbelastungen

Übertragung von Restaurant-, Bar- und Café-Rechnungen auf die Zimmerrechnung, Menü- und Bestandssynchronisierung.

Dokumentation in Vorbereitung
In Vorbereitung

Spa

Termine und Leistungen

Spa- und Wellnesstermine, Leistungskatalog und Belastung auf die Zimmerrechnung.

Dokumentation in Vorbereitung
In Vorbereitung

KI

Assistenz- und Empfehlungsdienste

Zugriff auf KI-Dienste für den Gästeassistenten, Preisempfehlungen und Berichte.

Dokumentation in Vorbereitung
In Vorbereitung

TV

TV-Systeme im Zimmer

Gästedaten, Zimmerrechnung, Nachrichten und Serviceanfragen für die TV-Oberfläche im Zimmer.

Dokumentation in Vorbereitung
In Vorbereitung

Telefonanlage

Telefonie und Gesprächsdaten

Anbindung der Telefonanlage: Freischalten und Sperren von Leitungen bei Check-in/-out, Buchung der Gesprächsgebühren auf die Zimmerrechnung.

Dokumentation in Vorbereitung

Gemeinsame Prinzipien aller Produkte

Wenn Sie ein Modul integriert haben, werden Ihnen die anderen vertraut vorkommen.

Hotelgebundener Schlüssel

Bei Online Booking wird das von HMS vergebene Paar apiKey/apiSecret gegen ein hotelgebundenes, 7 Tage gültiges Bearer-Token getauscht. Integrationen vor Ort wie Hotspot verwenden einen Schlüssel aus dem Panel des Hotels, der bei jeder Anfrage als ApiKey-Header gesendet wird.

Authentifizierung

success-Envelope

Antworten sind JSON und enthalten ein success-Flag. Fehler aus Geschäftsregeln kommen als HTTP 200 mit message oder errorCode zurück; Authentifizierungsfehler liefern 401.

Anfragen und Antworten

Lauffähige Beispiele

Für jeden Endpunkt werden cURL-, Node.js- und PHP-Beispiele erzeugt: kopieren, Schlüssel einsetzen, ausführen.

API-Referenz

Letzte Änderungen

Alle Versionshinweise

  • Website
    Unterstützung für 22 Sprachen
    NeuNeu
  • Hotspot
    Dokumentation der Hotspot API veröffentlicht
    NeuNeu
  • Online Booking
    Dokumentation der Online Booking API veröffentlicht
    NeuNeuNeu

Kommen Sie nicht weiter?

Unser Entwicklerteam antwortet innerhalb eines Werktags.

Fügen Sie Ihrer Meldung den Request-Body (geheime Schlüssel und Kartendaten maskiert), die Antwort und den Zeitpunkt bei. Dieselbe Adresse gilt für Partnerschlüssel, Testhotels und Vorabzugang.