اطلاعات هتل

داده‌هایی که قالب صفحات موتور رزرو را پر می‌کنند: اطلاعات تماس و موقعیت، پیوندهای شبکه‌های اجتماعی، متن‌های فوتر (متن‌های حقوقی، درباره هتل، کدهای Analytics و تبلیغات) و تنظیمات 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اشتباهی دیدید؟ به ما اطلاع دهید