Інформація про готель

Дані для оформлення сторінок модуля бронювання: контакти й розташування, посилання на соціальні мережі, тексти футера (юридична інформація, про готель, фрагменти коду аналітики й реклами) та налаштування SMTP для листів-підтверджень.

GET/external/hotel/{hotelID}/contact/infoКонтактні дані GET/external/online/social/mediaПосилання на соціальні мережі GET/external/online/footerТексти футера GET/external/online/mail/hostНалаштування поштового сервера

Контактні дані#

GET/external/hotel/{hotelID}/contact/info

Автентифікація: Authorization: Bearer

Параметри шляху

hotelIDintegerобов’язковий

Ідентифікатор готелю.

Відповідь

200 Успішно.

Відповіді з помилками

404 Готель не знайдено.

Запит

curl "https://test.hms.gen.tr/external/hotel/1000/contact/info" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/hotel/1000/contact/info", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/hotel/1000/contact/info');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Відповідь · 200

{
    "title": "Demo Otel",
    "phone": "+90 258 000 00 00",
    "cellPhone": "+90 555 000 00 00",
    "email": "[email protected]",
    "www": "https://www.demootel.com",
    "address": "Kumsal Cad. No: 12",
    "country": "Türkiye",
    "countryIng": "Turkey",
    "city": "Antalya",
    "district": "Muratpaşa",
    "latitude": "36.8841",
    "longitude": "30.7056"
}

Посилання на соціальні мережі#

GET/external/online/social/media

Автентифікація: Authorization: Bearer

Параметри запиту

hotelIDintegerобов’язковий

Ідентифікатор готелю.

limitintegerза замовчуванням: 20

Кількість записів на сторінці.

pageintegerза замовчуванням: 1

Номер сторінки.

orderstring

id або -id.

Відповідь

200 Успішно.

Запит

curl "https://test.hms.gen.tr/external/online/social/media?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/social/media?hotelID=1000", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/social/media?hotelID=1000');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Відповідь · 200

{
    "success": true,
    "count": 2,
    "items": [
        {
            "url": "https://www.instagram.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-instagram",
                "iconsvg": null
            }
        },
        {
            "url": "https://www.facebook.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-facebook",
                "iconsvg": null
            }
        }
    ]
}

Тексти футера#

GET/external/online/footer

Автентифікація: Authorization: Bearer

Повертає багатомовні тексти, введені в панелі в розділі «Online Booking → Футер». section вибирає блок: 0 — юридичні тексти (конфіденційність, дистанційний продаж…), 1 — про готель, 2 — фрагмент Analytics, 3 — фрагмент Ads.

Параметри запиту

hotelIDintegerобов’язковий

Ідентифікатор готелю.

sectioninteger

Розділ.

0123

Відповідь

200 Успішно.

Запит

curl "https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Відповідь · 200

{
    "success": true,
    "count": 1,
    "items": [
        {
            "id": 5,
            "title": "Договір дистанційного продажу",
            "status": 1,
            "section": 0,
            "items": [
                {
                    "title": "Mesafeli Satış Sözleşmesi",
                    "text": "<p>…</p>",
                    "language": "Türkçe",
                    "languageID": 1,
                    "languageCode": "tr"
                },
                {
                    "title": "Distance Sales Agreement",
                    "text": "<p>…</p>",
                    "language": "English",
                    "languageID": 2,
                    "languageCode": "en"
                }
            ]
        }
    ]
}

Налаштування поштового сервера#

GET/external/online/mail/host

Автентифікація: Authorization: Bearer

Повертає налаштування SMTP, які готель задав для листів-підтверджень онлайн-бронювань. Містить пароль, тому використовуйте лише на сервері.

Параметри запиту

hotelIDintegerобов’язковий

Ідентифікатор готелю.

Відповідь

200 Успішно.

Відповіді з помилками

200 mail_host_is_not_found — SMTP не налаштовано; hotel_id_is_not_found.

Запит

curl "https://test.hms.gen.tr/external/online/mail/host?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/mail/host?hotelID=1000", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/mail/host?hotelID=1000');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Відповідь · 200

{
    "success": true,
    "data": {
        "transport": "smtp",
        "encryption": "tls",
        "port": 587,
        "host": "smtp.demootel.com",
        "user": "[email protected]",
        "password": "********"
    }
}

Останнє оновлення: 21 вересня 2026 р.Знайшли помилку? Повідомте нам