Κουπόνι
Επικυρώνει τα online εκπτωτικά κουπόνια που έχει ορίσει το ξενοδοχείο στον πίνακα διαχείρισης. Εφαρμόστε την έκπτωση από τη δική σας πλευρά και στείλτε τα μειωμένα ποσά στην αποστολή της κράτησης.
Επικύρωση κουπονιού#
POST
/external/online/coupon/searchΈλεγχος ταυτότητας: Authorization: Bearer · Σώμα: application/x-www-form-urlencoded ή multipart/form-data
Ελέγχει ότι ο κωδικός κουπονιού είναι ενεργός, δεν έχει λήξει και είναι διαθέσιμος για αυτό το ξενοδοχείο· επιστρέφει τον τύπο και το ποσοστό της έκπτωσης.
Πεδία φόρμας
hotelIDintegerυποχρεωτικόΑναγνωριστικό ξενοδοχείου.
couponstringυποχρεωτικόΚωδικός κουπονιού που εισήγαγε ο επισκέπτης.
Απόκριση
200 Επιτυχία.
cupon.idintegerΑναγνωριστικό κουπονιού.
cupon.changeintegerΤύπος έκπτωσης:
0 ποσοστό (το rate είναι %), 1 σταθερό ποσό (το rate στο νόμισμα του ξενοδοχείου).cupon.ratestringΠοσοστό ή ποσό έκπτωσης.
Αποκρίσεις σφαλμάτων
- 200
online_cupon_is_not_found— άγνωστος, ανενεργός ή ληγμένος κωδικός·hotel_id_is_not_found— λείπει τοhotelID.
curl "https://test.hms.gen.tr/external/online/coupon/search" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" \
-d "coupon=KALOKAIRI2026"const res = await fetch("https://test.hms.gen.tr/external/online/coupon/search", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.HMS_TOKEN}`
},
body: new URLSearchParams([
["hotelID", "1000"],
["coupon", "KALOKAIRI2026"]
])
});
const data = await res.json();$ch = curl_init('https://test.hms.gen.tr/external/online/coupon/search');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('HMS_TOKEN'),
],
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query([
'hotelID' => '1000',
'coupon' => 'KALOKAIRI2026',
]),
]);
$data = json_decode(curl_exec($ch), true);{
"success": true,
"cupon": {
"id": 12,
"change": 0,
"rate": "10.00"
}
}{
"success": false,
"message": "online_cupon_is_not_found"
}