OntwikkelaarsportaalHMS Hotelsoftware

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 of ApiKey-header
Formaat
JSON-antwoorden met success-envelop
Live
2 producten · 17 endpoints
Binnenkort
5 producten
Verzoek
# 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"
Antwoord · 200 (ingekort)
{
    "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
}

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.

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.

Authenticatie

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.

Verzoeken en antwoorden

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-referentie

Recente wijzigingen

Alle releasenotes

  • Site
    Ondersteuning voor 22 talen
    NieuwNieuw
  • Hotspot
    Documentatie van de Hotspot API gepubliceerd
    NieuwNieuw
  • Online Booking
    Documentatie van de Online Booking API gepubliceerd
    NieuwNieuwNieuw

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.