Συνδέστε το λογισμικό σας με τις ενότητες του HMS
Ξεχωριστή τεκμηρίωση API για κάθε ενότητα του ξενοδοχειακού λογισμικού: μηχανή κρατήσεων, Wi-Fi επισκεπτών, POS εστιατορίου, spa, TV, τηλεφωνικό κέντρο και υπηρεσίες τεχνητής νοημοσύνης. Τα API του Online Booking και του Hotspot είναι ήδη σε λειτουργία· τα υπόλοιπα ακολουθούν.
- Έλεγχος ταυτότητας
- Token
Bearerή κεφαλίδαApiKey - Μορφή
- Αποκρίσεις JSON με φάκελο
success - Σε λειτουργία
- 2 προϊόντα · 17 τελικά σημεία
- Σε προετοιμασία
- 5 προϊόντα
# Ερώτημα δωματίων και τιμών
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"# Λίστα διαμενόντων επισκεπτών
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": "Standard Δωμάτιο",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Με πρωινό",
"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
}
]
}Προϊόντα
Κάθε προϊόν έχει τη δική του τεκμηρίωση, αναφορά API και παραδείγματα κώδικα. Όσα βρίσκονται σε προετοιμασία ανακοινώνονται στις σημειώσεις έκδοσης μόλις τεθούν σε λειτουργία.
Online Booking
API μηχανής κρατήσεων
Συνδέει τη μηχανή κρατήσεων του ιστότοπου του ξενοδοχείου με το HMS: λίστα δωματίων και τιμών, διαθεσιμότητα ημερολογίου, κουπόνια, πληρωμή και αποστολή κρατήσεων.
Hotspot
Wi-Fi επισκεπτών και καταγραφή 5651
Παρέχει στο σύστημα hotspot τη λίστα των διαμενόντων επισκεπτών: δωμάτιο, στοιχεία ταυτότητας, ώρες check-in και check-out. Για την επαλήθευση των συνδέσεων Wi-Fi των επισκεπτών με τον αριθμό δωματίου και την τήρηση αρχείων πρόσβασης σύμφωνα με τον τουρκικό νόμο αριθ. 5651.
POS εστιατορίου
Λογαριασμοί και χρεώσεις δωματίου
Μεταφορά λογαριασμών εστιατορίου, μπαρ και καφέ στο folio του δωματίου, συγχρονισμός μενού και αποθέματος.
Spa
Ραντεβού και υπηρεσίες
Ραντεβού spa και ευεξίας, κατάλογος υπηρεσιών και ενσωμάτωση χρεώσεων δωματίου.
Τεχνητή νοημοσύνη
Υπηρεσίες βοηθού και προτάσεων
Πρόσβαση σε υπηρεσίες τεχνητής νοημοσύνης για τον βοηθό επισκεπτών, τις προτάσεις τιμών και τις αναφορές.
TV
Συστήματα TV δωματίων
Στοιχεία επισκέπτη, folio, μηνύματα και αιτήματα υπηρεσιών για τη διεπαφή TV του δωματίου.
Τηλεφωνικό κέντρο
PBX και αρχεία κλήσεων
Ενσωμάτωση τηλεφωνικού κέντρου: ενεργοποίηση και απενεργοποίηση γραμμών κατά το check-in/out, χρέωση κλήσεων στο folio.
Κοινές αρχές σε όλα τα προϊόντα
Αφού ενσωματώσετε μία ενότητα, οι υπόλοιπες θα σας φανούν οικείες.
Κλειδί δεσμευμένο σε ξενοδοχείο
Στο Online Booking, τα apiKey/apiSecret που εκδίδει το HMS ανταλλάσσονται με ένα Bearer token δεσμευμένο σε ξενοδοχείο, που ισχύει για 7 ημέρες. Οι ενσωματώσεις εντός του ξενοδοχείου, όπως το Hotspot, χρησιμοποιούν κλειδί που δημιουργείται στον πίνακα διαχείρισης του ίδιου του ξενοδοχείου και αποστέλλεται σε κάθε αίτημα ως κεφαλίδα ApiKey.
Φάκελος success
Οι αποκρίσεις είναι JSON και περιέχουν την ένδειξη success. Τα σφάλματα επιχειρησιακών κανόνων επιστρέφονται ως HTTP 200 με message ή errorCode· τα σφάλματα ελέγχου ταυτότητας είναι 401.
Λειτουργικά παραδείγματα
Για κάθε τελικό σημείο παράγονται παραδείγματα cURL, Node.js και PHP· αντιγράψτε τα, προσθέστε το κλειδί σας και εκτελέστε τα.
Αναφορά APIΠρόσφατες αλλαγές
-
Υποστήριξη 22 γλωσσώνΝέοΝέο
-
Δημοσιεύθηκε η τεκμηρίωση του Hotspot APIΝέοΝέο
-
Δημοσιεύθηκε η τεκμηρίωση του Online Booking APIΝέοΝέοΝέο
Κολλήσατε;
Η ομάδα προγραμματιστών μας απαντά εντός μίας εργάσιμης ημέρας.
Συμπεριλάβετε το σώμα του αιτήματος (με απόκρυψη των μυστικών κλειδιών και των δεδομένων καρτών), την απόκριση και την ώρα. Στην ίδια διεύθυνση απευθυνθείτε και για κλειδιά συνεργάτη, δοκιμαστικά ξενοδοχεία και πρόωρη πρόσβαση.