Portal pentru dezvoltatoriHMS Software Hotelier

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 Bearer sau antet ApiKey
Format
Răspunsuri JSON cu înveliș success
Disponibil
2 produse · 17 endpointuri
În pregătire
5 produse
Cerere
# 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"
Răspuns · 200 (trunchiat)
{
    "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
}

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.

Disponibil

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.

8 resurse · 16 endpointuriDocumentație
Disponibil

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.

1 resursă · 1 endpointDocumentație
În pregătire

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.

Documentație în pregătire
În pregătire

Spa

Programări și servicii

Programări la spa și wellness, catalog de servicii și integrare pentru debitarea în contul camerei.

Documentație în pregătire
În pregătire

AI

Servicii de asistent și recomandări

Acces la serviciile AI pentru asistentul oaspeților, recomandări de tarife și raportare.

Documentație în pregătire
În pregătire

TV

Sisteme TV în cameră

Datele oaspetelui, contul camerei, mesaje și cereri de servicii pentru interfața TV din cameră.

Documentație în pregătire
În pregătire

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.

Documentație în pregătire

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.

Autentificare

Î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.

Cereri și răspunsuri

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ță API

Modificări recente

Toate notele de versiune

  • Site
    Suport pentru 22 de limbi
    NouNou
  • Hotspot
    Documentația API Hotspot a fost publicată
    NouNou
  • Online Booking
    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.