معلومات الفندق

بيانات تملأ الإطار العام لصفحات محرك الحجز: بيانات الاتصال والموقع، وروابط وسائل التواصل الاجتماعي، ونصوص التذييل (النصوص القانونية، ونبذة عن الفندق، ومقتطفات التحليلات/الإعلانات)، وإعدادات 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هل وجدت خطأً؟ أخبرنا