Πύλη προγραμματιστώνΞενοδοχειακό λογισμικό HMS

Συνδέστε το λογισμικό σας με τις ενότητες του 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"
Απόκριση · 200 (περικομμένη)
{
    "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
}

Προϊόντα

Κάθε προϊόν έχει τη δική του τεκμηρίωση, αναφορά API και παραδείγματα κώδικα. Όσα βρίσκονται σε προετοιμασία ανακοινώνονται στις σημειώσεις έκδοσης μόλις τεθούν σε λειτουργία.

Σε λειτουργία

Online Booking

API μηχανής κρατήσεων

Συνδέει τη μηχανή κρατήσεων του ιστότοπου του ξενοδοχείου με το HMS: λίστα δωματίων και τιμών, διαθεσιμότητα ημερολογίου, κουπόνια, πληρωμή και αποστολή κρατήσεων.

8 πόροι · 16 τελικά σημείαΤεκμηρίωση
Σε λειτουργία

Hotspot

Wi-Fi επισκεπτών και καταγραφή 5651

Παρέχει στο σύστημα hotspot τη λίστα των διαμενόντων επισκεπτών: δωμάτιο, στοιχεία ταυτότητας, ώρες check-in και check-out. Για την επαλήθευση των συνδέσεων Wi-Fi των επισκεπτών με τον αριθμό δωματίου και την τήρηση αρχείων πρόσβασης σύμφωνα με τον τουρκικό νόμο αριθ. 5651.

1 πόρος · 1 τελικό σημείοΤεκμηρίωση
Σε προετοιμασία

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
    Δημοσιεύθηκε η τεκμηρίωση του Hotspot API
    ΝέοΝέο
  • Online Booking
    Δημοσιεύθηκε η τεκμηρίωση του Online Booking API
    ΝέοΝέοΝέο

Κολλήσατε;

Η ομάδα προγραμματιστών μας απαντά εντός μίας εργάσιμης ημέρας.

Συμπεριλάβετε το σώμα του αιτήματος (με απόκρυψη των μυστικών κλειδιών και των δεδομένων καρτών), την απόκριση και την ώρα. Στην ίδια διεύθυνση απευθυνθείτε και για κλειδιά συνεργάτη, δοκιμαστικά ξενοδοχεία και πρόωρη πρόσβαση.