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 oderApiKey-Header- Format
- JSON-Antworten mit
success-Envelope - Verfügbar
- 2 Produkte · 17 Endpunkte
- In Vorbereitung
- 5 Produkte
# 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"# Liste der Gäste im Haus
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Produkte
Jedes Produkt hat eine eigene Dokumentation, API-Referenz und Codebeispiele. Neue Produkte werden bei ihrer Veröffentlichung in den Versionshinweisen angekündigt.
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.
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.
Restaurant-POS
Rechnungen und Zimmerbelastungen
Übertragung von Restaurant-, Bar- und Café-Rechnungen auf die Zimmerrechnung, Menü- und Bestandssynchronisierung.
Spa
Termine und Leistungen
Spa- und Wellnesstermine, Leistungskatalog und Belastung auf die Zimmerrechnung.
KI
Assistenz- und Empfehlungsdienste
Zugriff auf KI-Dienste für den Gästeassistenten, Preisempfehlungen und Berichte.
TV
TV-Systeme im Zimmer
Gästedaten, Zimmerrechnung, Nachrichten und Serviceanfragen für die TV-Oberfläche im Zimmer.
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.
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.
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.
Lauffähige Beispiele
Für jeden Endpunkt werden cURL-, Node.js- und PHP-Beispiele erzeugt: kopieren, Schlüssel einsetzen, ausführen.
API-ReferenzLetzte Änderungen
-
Unterstützung für 22 SprachenNeuNeu
-
Dokumentation der Hotspot API veröffentlichtNeuNeu
-
Dokumentation der Online Booking API veröffentlichtNeuNeuNeu
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.