Αιτήματα και αποκρίσεις

Αυτή η σελίδα καλύπτει τις μορφές σώματος αιτήματος, τον φάκελο της απόκρισης, τη σελιδοποίηση, τις μορφές ημερομηνιών και ποσών, καθώς και την ερμηνεία των κωδικών κατάστασης HTTP.

Σώματα αιτημάτων#

Τα τελικά σημεία χρησιμοποιούν μία από δύο μορφές σώματος. Η σελίδα αναφοράς κάθε τελικού σημείου αναφέρει ποια ισχύει.

Μορφή	Content-Type	Χρησιμοποιείται από
Πεδία φόρμας	`application/x-www-form-urlencoded` ή `multipart/form-data`	Σύνδεση, λίστα δωματίων, επικύρωση κουπονιού, χώρες
JSON	`application/json`	Αποστολή κράτησης (`BookingPushRQ`), έναρξη πληρωμής
Query string	—	Όλα τα τελικά σημεία `GET`

Τα πεδία πινάκων σε σώματα φόρμας επαναλαμβάνονται με αγκύλες: childAges[]=7&childAges[]=12. Τα σώματα JSON πρέπει να είναι σε UTF-8.

Φάκελος απόκρισης#

Οι αποκρίσεις είναι JSON. Οι περισσότερες περιέχουν την ένδειξη success· οι λίστες επιστρέφονται με count και items:

Απόκριση λίστας (περικομμένη)

{
    "success": true,
    "count": 3,
    "items": [
        {
            "id": 1,
            "titleCode": "TRY",
            "symbol": "₺",
            "price": 1
        },
        {
            "id": 2,
            "titleCode": "EUR",
            "symbol": "€",
            "price": 47.85000000000000142108547152020037174224853515625
        }
    ]
}

Οι αποτυχημένοι έλεγχοι επιχειρησιακών κανόνων επιστρέφουν success: false μαζί με μια περιγραφή του σφάλματος, σε μία από δύο μορφές:

Μορφή message

{
    "success": false,
    "message": "online_cupon_is_not_found"
}

Μορφή errorCode (λίστα δωματίων)

{
    "success": false,
    "errorMessage": "Invalid parameters.",
    "errorCode": 10022
}

Εξαιρέσεις: το τελικό σημείο στοιχείων επικοινωνίας επιστρέφει σκέτο αντικείμενο χωρίς φάκελο, ενώ η αποστολή κράτησης επιστρέφει αντικείμενο BookingPushRS. Και τα δύο εμφανίζονται στην αναφορά.

Κωδικοί κατάστασης HTTP#

Κωδικός	Πότε	Τι κάνετε
200	Το αίτημα επεξεργάστηκε (επιτυχία ή σφάλμα επιχειρησιακού κανόνα)	Ελέγξτε τα `success`, `message` / `errorCode`.
401	Το token λείπει, έχει λανθασμένη μορφή ή είναι άγνωστο	Συνδεθείτε ξανά· δείτε την ενότητα Έλεγχος ταυτότητας.
404	Μια παράμετρος διαδρομής δεν αντιστοιχεί σε εγγραφή (π.χ. `/hotel/{hotelID}/…`, `/payment/type/{paymentType}`)	Ελέγξτε το αναγνωριστικό.
405	Λάθος μέθοδος HTTP	Χρησιμοποιήστε τη μέθοδο που αναφέρεται στην αναφορά (οι χώρες και η λίστα δωματίων είναι `POST`).
500	Απρόσμενο σφάλμα διακομιστή	Επαναλάβετε μετά από μια σύντομη καθυστέρηση· αν επιμένει, ανοίξτε αίτημα υποστήριξης με το αίτημα.

Σελιδοποίηση#

Τα τελικά σημεία λιστών (/external/currencies, /external/languages, /external/online/social/media, /external/stock/packages) σελιδοποιούνται με αριθμό σελίδας:

Παράμετρος	Περιγραφή	Προεπιλογή
`limit`	Εγγραφές ανά σελίδα.	`20`
`page`	Αριθμός σελίδας, ξεκινώντας από το 1.	`1`
`offset`	Εγγραφές που παραλείπονται. Αν δοθεί, το `page` αγνοείται.	—
`order`	Πεδίο ταξινόμησης· με πρόθεμα `-` για φθίνουσα σειρά (`-id`). Τα επιτρεπτά πεδία αναφέρονται ανά τελικό σημείο.	—

Το count είναι ο συνολικός αριθμός εγγραφών· η λίστα έχει εξαντληθεί όταν page × limit ≥ count.

Ημερομηνίες, ώρες και ποσά#

Τύπος	Μορφή	Παράδειγμα
Ημερομηνία αιτήματος	`YYYY-MM-DD`	`2026-08-18`
Ημερομηνία διαθεσιμότητας	`YYYY-MM-DD` ή `YYYY-MM-DDTHH:MM:SS`	`2026-08-18T12:00:00`
Ημερομηνία τιμής ανά διανυκτέρευση (απόκριση)	`DD.MM.YYYY` (το πεδίο `tarih`)	`18.08.2026`
Εύρος ημέρας διαθεσιμότητας (απόκριση)	`YYYY-MM-DD HH:MM:SS`, από 12:00 έως 12:00 της επόμενης ημέρας	`2026-08-18 12:00:00`
Ποσό	Συμβολοσειρά με δύο δεκαδικά, με τελεία ως διαχωριστικό	`"965.00"`
Νόμισμα	ISO 4217· από τις ρυθμίσεις του online καναλιού του ξενοδοχείου	`TRY`
Ζώνη ώρας	Η ζώνη ώρας του ξενοδοχείου	Europe/Istanbul

Η ημερομηνία αναχώρησης δεν αποτελεί μέρος της διαμονής: 18–20 Αυγούστου σημαίνει δύο διανυκτερεύσεις. Μην προσθέτετε ποσά με float· χρησιμοποιήστε μια βιβλιοθήκη δεκαδικών ή ακέραιες υποδιαιρέσεις του νομίσματος.

Γλώσσα#

Η λίστα δωματίων δέχεται το πεδίο language (ISO 639-1: tr, en, de…) και επιστρέφει ονόματα δωματίων, τίτλους χαρακτηριστικών και μηνύματα σφάλματος σε αυτή τη γλώσσα. Η λίστα πακέτων αναμένει languageID· τα αναγνωριστικά προέρχονται από το τελικό σημείο Γλώσσες.

Τελευταία ενημέρωση: 21 Σεπτεμβρίου 2026Βρήκατε κάποιο λάθος; Ενημερώστε μας