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
Bearerou en-têteApiKey - Format
- Réponses JSON, enveloppe
success - En ligne
- 2 produits · 17 endpoints
- À venir
- 5 produits
# 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"# Liste des clients en séjour
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": "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
}{
"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
}
]
}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.
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.
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.
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.
Spa
Rendez-vous et prestations
Rendez-vous spa et bien-être, catalogue des prestations et intégration de l’imputation en chambre.
IA
Services d’assistant et de recommandation
Accès aux services d’IA pour l’assistant client, les recommandations tarifaires et le reporting.
TV
Systèmes de TV en chambre
Informations client, folio, messages et demandes de service pour l’interface TV en chambre.
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.
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.
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.
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 APIModifications récentes
-
Prise en charge de 22 languesNouveauNouveau
-
Documentation de l’API Hotspot publiéeNouveauNouveau
-
Documentation de l’API Online Booking publiéeNouveauNouveauNouveau
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é.