Koppel je software aan de modules van HMS
Aparte API-documentatie voor elke module van de hotelsoftware: boekingsmodule, gast-wifi, restaurant-POS, spa, tv, telefooncentrale en AI-diensten. De API’s van Online Booking en Hotspot zijn nu live; de andere volgen.
- Authenticatie
Bearer-token ofApiKey-header- Formaat
- JSON-antwoorden met
success-envelop - Live
- 2 producten · 17 endpoints
- Binnenkort
- 5 producten
# Kamers en tarieven opvragen
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"# Lijst met aanwezige gasten
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": "Standaardkamer",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Logies en ontbijt",
"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
}
]
}Producten
Elk product heeft een eigen documentatie, API-referentie en codevoorbeelden. Producten die nog in voorbereiding zijn, worden in de releasenotes aangekondigd zodra ze live gaan.
Online Booking
API voor de boekingsmodule
Koppelt de boekingsmodule op de website van het hotel aan HMS: kamer- en tarievenlijst, beschikbaarheidskalender, kortingscodes, betaling en het doorsturen van boekingen.
Hotspot
Gast-wifi en logging volgens Wet nr. 5651
Levert de lijst met aanwezige gasten aan het hotspotsysteem: kamer, identiteit, in- en uitchecktijden. Voor het verifiëren van wifi-logins van gasten op kamernummer en het bijhouden van toegangslogs volgens de Turkse Wet nr. 5651.
Restaurant-POS
Bonnen en boeken op de kamer
Doorboeken van restaurant-, bar- en cafébonnen naar het kamerfolio, synchronisatie van menu en voorraad.
Spa
Afspraken en diensten
Spa- en wellnessafspraken, dienstencatalogus en koppeling voor boeken op de kamer.
AI
Assistent- en aanbevelingsdiensten
Toegang tot AI-diensten voor de gastassistent, tariefadviezen en rapportages.
TV
Tv-systemen op de kamer
Gastgegevens, folio, berichten en serviceverzoeken voor de tv-interface op de kamer.
Telefooncentrale
PBX-koppeling en gespreksregistratie
Koppeling met de telefooncentrale: lijnen openen en sluiten bij in- en uitchecken, gesprekskosten op het folio boeken.
Principes voor alle producten
Heb je één module geïntegreerd, dan zullen de andere vertrouwd aanvoelen.
Hotelgebonden sleutel
Bij Online Booking wissel je de door HMS verstrekte apiKey/apiSecret in voor een hotelgebonden Bearer-token dat 7 dagen geldig is. Integraties binnen het hotel, zoals Hotspot, gebruiken een sleutel die in het eigen beheerpaneel van het hotel wordt aangemaakt en bij elk verzoek als ApiKey-header wordt meegestuurd.
success-envelop
Antwoorden zijn JSON en bevatten een success-veld. Fouten in de bedrijfslogica komen terug als HTTP 200 met message of errorCode; authenticatiefouten geven 401.
Werkende voorbeelden
Voor elk endpoint worden voorbeelden in cURL, Node.js en PHP gegenereerd; kopieer ze, vul je sleutel in en voer ze uit.
API-referentieRecente wijzigingen
-
Ondersteuning voor 22 talenNieuwNieuw
-
Documentatie van de Hotspot API gepubliceerdNieuwNieuw
-
Documentatie van de Online Booking API gepubliceerdNieuwNieuwNieuw
Kom je er niet uit?
Ons ontwikkelteam reageert binnen één werkdag.
Voeg de body van het verzoek (met gemaskeerde geheimen en kaartgegevens), het antwoord en het tijdstip toe. Gebruik hetzelfde adres voor partnersleutels, testhotels en vroege toegang.