Portail développeursLogiciel hôtelier HMS

Connectez votre logiciel aux modules HMS

Une documentation API distincte pour chaque module du logiciel hôtelier : moteur de réservation, Wi-Fi clients, POS restaurant, spa, TV, standard téléphonique et services d’IA. Les API Online Booking et Hotspot sont déjà en ligne ; les autres suivront.

Authentification
Jeton Bearer ou en-tête ApiKey
Format
Réponses JSON, enveloppe success
En ligne
2 produits · 17 endpoints
À venir
5 produits
Requête
# Requête de chambres et tarifs
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éponse · 200 (tronquée)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Chambre standard",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Petit-déjeuner inclus",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Produits

Chaque produit a sa propre documentation, sa référence API et ses exemples de code. Les produits à venir sont annoncés dans les notes de version dès leur mise en ligne.

En ligne

Online Booking

API du moteur de réservation

Connecte le moteur de réservation du site web de l’hôtel à HMS : liste des chambres et des tarifs, disponibilités en calendrier, coupons, paiement et transmission des réservations.

8 ressources · 16 endpointsDocumentation
En ligne

Hotspot

Wi-Fi clients et journalisation loi 5651

Transmet la liste des clients en séjour au système hotspot : chambre, identité, heures d’arrivée et de départ. Pour vérifier les connexions Wi-Fi des clients par numéro de chambre et tenir les journaux d’accès exigés par la loi turque n° 5651.

1 ressource · 1 endpointDocumentation
À venir

POS Restaurant

Additions et imputations en chambre

Imputation des additions du restaurant, du bar et du café sur le folio de la chambre, synchronisation des menus et des stocks.

Documentation en préparation
À venir

Spa

Rendez-vous et prestations

Rendez-vous spa et bien-être, catalogue des prestations et intégration de l’imputation en chambre.

Documentation en préparation
À venir

IA

Services d’assistant et de recommandation

Accès aux services d’IA pour l’assistant client, les recommandations tarifaires et le reporting.

Documentation en préparation
À venir

TV

Systèmes de TV en chambre

Informations client, folio, messages et demandes de service pour l’interface TV en chambre.

Documentation en préparation
À venir

Standard téléphonique

PABX et journal des appels

Intégration du standard téléphonique : ouverture et fermeture des lignes au check-in/check-out, imputation des frais d’appel sur le folio.

Documentation en préparation

Principes communs à tous les produits

Une fois un module intégré, les autres vous sembleront familiers.

Clé liée à l’hôtel

Dans Online Booking, la paire apiKey/apiSecret délivrée par HMS est échangée contre un jeton Bearer lié à l’hôtel et valable 7 jours. Les intégrations sur site comme Hotspot utilisent une clé générée dans le panneau de l’hôtel, envoyée dans l’en-tête ApiKey à chaque requête.

Authentification

Enveloppe success

Les réponses sont en JSON et contiennent un champ success. Les erreurs métier sont renvoyées en HTTP 200 avec message ou errorCode ; les erreurs d’authentification renvoient 401.

Requêtes et réponses

Exemples prêts à l’emploi

Des exemples cURL, Node.js et PHP sont générés pour chaque endpoint : copiez-les, ajoutez votre clé et exécutez-les.

Référence API

Modifications récentes

Toutes les notes de version

  • Site
    Prise en charge de 22 langues
    NouveauNouveau
  • Hotspot
    Documentation de l’API Hotspot publiée
    NouveauNouveau
  • Online Booking
    Documentation de l’API Online Booking publiée
    NouveauNouveauNouveau

Besoin d’aide ?

Notre équipe de développement répond sous un jour ouvré.

Joignez le corps de la requête (secrets et données de carte masqués), la réponse et l’horodatage. Utilisez la même adresse pour les clés partenaires, les hôtels de test et l’accès anticipé.