Conectați-vă software-ul la modulele HMS
Documentație API separată pentru fiecare modul al software-ului hotelier: motor de rezervări, Wi-Fi pentru oaspeți, POS restaurant, spa, TV, centrală telefonică și servicii AI. API-urile Online Booking și Hotspot sunt disponibile acum; celelalte urmează.
- Autentificare
- Token
Bearersau antetApiKey - Format
- Răspunsuri JSON cu înveliș
success - Disponibil
- 2 produse · 17 endpointuri
- În pregătire
- 5 produse
# Interogare de camere și tarife
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"# Lista oaspeților cazați
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": "Cameră Standard",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Mic dejun inclus",
"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
}
]
}Produse
Fiecare produs are propria documentație, referință API și exemple de cod. Cele aflate în pregătire sunt anunțate în notele de versiune când devin disponibile.
Online Booking
API pentru motorul de rezervări
Conectează motorul de rezervări de pe site-ul hotelului la HMS: lista de camere și tarife, disponibilitatea în calendar, cupoane, plata și transmiterea rezervărilor.
Hotspot
Wi-Fi pentru oaspeți și jurnalizare 5651
Transmite sistemului hotspot lista oaspeților cazați: camera, identitatea, orele de check-in și check-out. Pentru verificarea autentificărilor la Wi-Fi ale oaspeților după numărul camerei și pentru păstrarea jurnalelor de acces cerute de Legea turcă nr. 5651.
POS restaurant
Note de plată și debitare pe cameră
Trecerea notelor de plată de la restaurant, bar și cafenea în contul camerei, sincronizarea meniului și a stocurilor.
Spa
Programări și servicii
Programări la spa și wellness, catalog de servicii și integrare pentru debitarea în contul camerei.
AI
Servicii de asistent și recomandări
Acces la serviciile AI pentru asistentul oaspeților, recomandări de tarife și raportare.
TV
Sisteme TV în cameră
Datele oaspetelui, contul camerei, mesaje și cereri de servicii pentru interfața TV din cameră.
Centrală telefonică
Centrală telefonică și evidența apelurilor
Integrare cu centrala telefonică: activarea și dezactivarea liniilor la check-in/check-out, trecerea costului apelurilor în contul camerei.
Principii comune tuturor produselor
După ce ați integrat un modul, celelalte vă vor părea familiare.
Cheie legată de hotel
În Online Booking, perechea apiKey/apiSecret emisă de HMS se schimbă pe un token Bearer legat de hotel, valabil 7 zile. Integrările instalate la hotel, precum Hotspot, folosesc o cheie generată în panoul propriu al hotelului, trimisă în antetul ApiKey la fiecare cerere.
Învelișul success
Răspunsurile sunt JSON și conțin indicatorul success. Erorile de logică de business vin ca HTTP 200, cu message sau errorCode; erorile de autentificare sunt 401.
Exemple funcționale
Pentru fiecare endpoint sunt generate exemple cURL, Node.js și PHP; copiați-le, adăugați cheia și rulați-le.
Referință APIModificări recente
-
Suport pentru 22 de limbiNouNou
-
Documentația API Hotspot a fost publicatăNouNou
-
Documentația API Online Booking a fost publicatăNouNouNou
V-ați blocat?
Echipa noastră de dezvoltatori răspunde în cel mult o zi lucrătoare.
Includeți corpul cererii (cu secretele și datele de card mascate), răspunsul și ora. Folosiți aceeași adresă pentru chei de partener, hoteluri de test și acces anticipat.