عرض تجريبي مباشر

API الإقامة

API الإقامات للفنادق والشقق وبيوت العطلات

يوصل API الإقامات كل أنواع الإقامة إلى موقع الحجز لديكم: غرف الفنادق والشقق الفندقية وبيوت العطلات والنُّزُل وبيوت الضيافة. تشرح هذه الصفحة البيانات وراء الإقامة، والقواعد التي تميّز الإيجارات عن الفنادق، وكيف تبيع PHPTRAVELS عقاراتكم الخاصة ومخزون المورّدين في بحث واحد.

  • العقار والوحدة والسعر والتقويم
  • الحد الأدنى للإقامة والرسوم
  • مهل الإلغاء
  • مخزون خاص مع مخزون API

نموذج البيانات

أربع طبقات داخل كل إقامة

سواء كان فندقاً من 300 غرفة أو بيتاً واحداً على الشاطئ، يصفه API الإقامة بالطبقات الأربع المتداخلة نفسها. وتجيب كل طبقة عن سؤال مختلف يطرحه الضيف قبل الحجز.

01العقار

المكان نفسه: الاسم والنوع والعنوان وموقع الخريطة والصور والمرافق وتصنيف النجوم أو الجودة وقواعد المكان وأوقات تسجيل الوصول.

property_id · type · address · geo · photos · amenities · check_in_from

02الغرفة أو الوحدة

ما يُحجز فعلاً: نوع غرفة أو شقة كاملة أو سرير في عنبر مشترك، بمساحته وأسرّته وأقصى عدد للنزلاء.

unit_id · beds · size_m2 · max_adults · max_children

03الخطة السعرية

كيف تُباع تلك الوحدة: الوجبات وسياسة الإلغاء وشروط الدفع ومن يحق له الحجز، كالجمهور أو الوكلاء فقط.

rate_plan_id · board · cancel_policy · payment · channel

04التوفر

سطر لكل ليلة: السعر والوحدات المتبقية والحد الأدنى للإقامة وهل يُسمح بالوصول أو المغادرة في ذلك اليوم.

date · price · units_left · min_stay · closed_to_arrival

مبنى وغرفة وبطاقة سعر وتقويم مرسومة كطبقات منفصلة متراصّة لإعلان إقامة واحد

تسمّي PHPTRAVELS وحدة الإقامة لديها Stays لأن النموذج نفسه يغطي أكثر بكثير من الفنادق. يضم العقار وحدات، وتُباع الوحدة عبر خطة سعرية أو أكثر، ولكل خطة سعرية تقويم ليلة بليلة للسعر والتوفر. إذا أُحكمت هذه الطبقات الأربع، اتسع البحث والدفع نفسهما لسرير في نُزُل وجناح فندقي وفيلا من ثلاث غرف نوم.

يسمّي المورّدون الطبقات بأسماء مختلفة، ويدمج بعضهم طبقتين، لكن البنية موجودة دائماً. ويربط الفنادق كل مصدر بها فيرى الضيف صفحة واحدة متسقة.

ليلة بليلة

تقويم التوفر هو ما يربح الإقامة أو يخسرها

ينتهي كل API إقامات إلى تقويم. ولا يُرجع البحث عقاراً إلا إذا كانت كل ليلة من الإقامة المطلوبة متاحة ومسعّرة ومسموحة وفق قواعد الإقامة.

شقة بغرفتي نوم · السعر القياسينوفمبر 2026 · السعر لكل ليلة
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • متاحة، بسعر لكل ليلة
  • محجوزة مسبقاً
  • مغلقة من المالك
  • حد أدنى للإقامة عند الوصول في هذا اليوم
  • مغلقة للوصول

بيانات توضيحية مبسّطة

  • الأسعار لكل ليلةإجمالي الإقامة هو مجموع كل ليلة، فجمعة وسبت بأسعار نهاية الأسبوع أغلى من يومين في وسط الأسبوع. تُحفظ أسعار الأيام والمواسم في التقويم لا في العقار.
  • قواعد الحد الأدنى للإقامةحد أدنى من ثلاث ليال عند الوصول يوم الجمعة يُخفي الوحدة عن بحث لليلتين. تستخدم الإيجارات هذه القواعد أكثر بكثير من الفنادق، وغالباً بصرامة أكبر في عطلة نهاية الأسبوع وموسم الذروة.
  • مغلقة للوصول أو المغادرةقد تكون الليلة قابلة للحجز ضمن إقامة أطول لكن ليس كأول ليلة أو آخر ليلة. هكذا تعمل أيام التبديل في بيوت العطلات.
  • الليالي المغلقة ووقف البيعيحجب الملاك تواريخ لاستخدامهم أو للصيانة، ويسحب وقف البيع الوحدة من البيع فوراً. وأي ليلة مغلقة ضمن التواريخ المطلوبة تُخرج الوحدة من النتائج.

ليست كل إقامة فندقاً

الفنادق مقابل الشقق وبيوت العطلات

نموذج البيانات مشترك، لكن كل نوع من الإقامة يملؤه بطريقة مختلفة. هذه هي الفروق التي يجب أن يعالجها مسار الحجز لديكم عندما تبيعون أكثر من غرف الفنادق.

الفنادق

تشمل النُّزُل وبيوت الضيافة

ما يُحجز
نوع غرفة له غرف متطابقة كثيرة، أو سرير في عنبر مشترك.
التسعير
سعر ليلة لكل غرفة ونظام وجبات؛ وقد يغيّره البالغون أو الأطفال الإضافيون.
قواعد الإقامة
حد أدنى للإقامة في تواريخ الذروة فقط؛ ومعظم الليالي تُحجز منفردة.
الرسوم والتأمينات
ضريبة المدينة أو السياحة، وأحياناً رسم منتجع يُدفع في المكان.
الوصول
مكتب استقبال يعمل 24 ساعة أو بموظفين؛ ويكفي ذكر أوقات الوصول في القسيمة.
المصدر المعتاد
بنوك الأسرّة وتجار الجملة والعقود المباشرة ومديرو القنوات.

الشقق الفندقية

الفنادق الشقق وشقق المدن

ما يُحجز
نوع وحدة، غالباً بمطبخ وغرف نوم منفصلة.
التسعير
سعر ليلة لكل وحدة، مع أسعار أسبوعية أو شهرية للإقامات الطويلة.
قواعد الإقامة
الحد الأدنى للإقامة شائع، والإقامات الطويلة جزء كبير من الطلب.
الرسوم والتأمينات
رسم تنظيف لكل إقامة وتأمين مسترد أمران شائعان.
الوصول
تتفاوت ساعات الاستقبال؛ والوصول المتأخر يحتاج صندوق مفاتيح أو رمزاً.
المصدر المعتاد
مديرو القنوات والعقود المباشرة وبعض تجار الجملة.

بيوت العطلات

بيوت العطلات والفلل والأكواخ

ما يُحجز
بيت محدد بعينه. وعادةً لا يوجد منه إلا واحد.
التسعير
سعر ليلة للبيت كله، إضافة إلى رسم لكل ضيف زائد على عدد أساسي.
قواعد الإقامة
الحد الأدنى للإقامة وأيام التبديل الثابتة وتواريخ الإغلاق للوصول هي القاعدة.
الرسوم والتأمينات
رسم تنظيف وتأمين مسترد للأضرار وضرائب محلية، يُعرض كلٌّ منها قبل الدفع.
الوصول
تُرسل تعليمات الوصول والعنوان وجهة الاتصال قبل الوصول، ولا تُنشر أبداً في الصفحة العامة.
المصدر المعتاد
الملاك ومديرو العقارات، مباشرة أو عبر مدير قنوات.

هل تبيعون بيوتاً من مضيفين كثر بدل عقودكم الخاصة؟ هذا سوق إلكتروني، وتجدونه في صفحة بوابة BnB.

مهل سياسة الإلغاء

حجز واحد وثلاث مهل للإلغاء

سياسة الإلغاء جدول زمني يُحسب تراجعياً من تاريخ الوصول. وتحدد كل مهلة ما يستردّه الضيف إذا ألغى ضمنها.

الحجزتسجيل الوصول
  1. 01 · حتى 14 يوماً قبل الوصولإلغاء مجانييلغي الضيف ويُردّ إليه المبلغ كاملاً. هذا أول موعد نهائي يبحث عنه المسافرون، فاعرضوه كتاريخ لا كقاعدة.
  2. 02 · من 14 إلى 3 أيام قبل الوصولغرامة جزئيةتُطبَّق غرامة، غالباً الليلة الأولى أو نسبة من الإقامة. وقد تحتفظ الإيجارات بالتأمين ضمن هذه المهلة.
  3. 03 · آخر 3 أيام وعدم الحضورغير قابل للاسترداديُحتفظ بالمبلغ كاملاً. والخطط السعرية المباعة بوصفها غير قابلة للاسترداد تبدأ في هذه المهلة منذ لحظة الحجز.
مهل توضيحية؛ ولكل خطة سعرية مهلها.
  • لكل خطة سعرية لا لكل عقارقد تكون للشقة نفسها خطة مرنة وأخرى أرخص غير قابلة للاسترداد، لذا تتبع السياسة طبقة الخطة السعرية.
  • التواريخ بتوقيت العقارتُحسب "قبل 14 يوماً" من تاريخ الوصول في مكان العقار. حوّلوها إلى تاريخ ووقت واضحين في الصفحة والقسيمة.
  • سياسة المورّد هي المعتمدةمع مخزون الـ API لا يمكنكم تقديم شروط أخف مما يمنحكم المورّد. أما مع عقودكم الخاصة فتحددون المهل بأنفسكم.

المخزون الخاص ومخزون الـ API

عقاراتكم المتعاقد عليها وواجهات المورّدين في بحث واحد

يجمع معظم بائعي الإقامة بين الأمرين: يحمّلون الأماكن التي يتعاقدون عليها بأنفسهم ويضيفون واجهات المورّدين لكل ما عداها. ولا ينبغي أن يلاحظ المسافر مصدر الإقامة.

عقاراتكم الخاصة

  • حمّلوا العقارات والوحدات والخطط السعرية بأنفسكم من لوحة الإدارة
  • امنحوا الملاك والفنادق حساب إكسترانت لإدارة تقويمهم
  • حددوا الأسعار والحد الأدنى للإقامة والتواريخ المغلقة ومهل الإلغاء
  • حصص مع أيام إطلاق ووقف البيع
  • أو استقبلوا الأسعار والتوفر من مدير قنوات

مخزون واجهات المورّدين

  • كتالوجات ضخمة في وجهات لا يمكنكم التعاقد عليها أبداً
  • أسعار وتوفر مباشران وقت البحث
  • وجبات المورّد وسياساته ورسومه على كل سعر
  • تُفعَّل بعقدكم وبيانات اعتمادكم لدى المورّد
  • يُرسل الحجز والإلغاء مباشرة إلى المورّد

ما يحصل عليه الضيف

  • قائمة نتائج واحدة وصفحة عقار واحدة لكل مكان
  • الغرفة نفسها من عدة مصادر تظهر مرة واحدة وبسعركم
  • هوامش ربحكم حسب المورّد أو الوجهة أو القناة، وأسعار الوكلاء B2B
  • صيغة قسيمة واحدة أياً كان المصدر الذي أكّد الحجز

يُشرح ربط مدير القنوات في تكامل مديري القنوات. وللغرف التي تملكون حقها بالعقد، انظروا نظام مخزون الحجوزات.

جاهز في PHPTRAVELS

مورّدو Stays المتصلون بالفعل

هؤلاء مورّدو الإقامة المتصلون اليوم بوحدة Stays. توقّعون مع المورّد، وتُدخلون بيانات اعتمادكم في لوحة الإدارة، وتختبرون في بيئته التجريبية ثم تنطلقون. وتأتي القائمة مباشرة من دليل التكاملات لدينا.

هل تحتاجون مورّداً غير مدرج، مثل شبكة إيجارات إقليمية؟ يمكن إضافة أي API إقامة له توثيق، انظروا تكامل API مخصص. ولأنواع مورّدي الفنادق وربط المحتوى، اقرؤوا صفحة API الفنادق، ودليلَي أكبر بنكَي أسرّة: تكامل RateHawk API وتكامل Hotelbeds API.

احجزوا إقامة كما سيفعل ضيوفكم

ابحثوا وقارنوا الأسعار واحجزوا في العرض المباشر، ثم أخبرونا بالعقارات والمورّدين الذين تخططون لبيعهم.

جرّبوا العرض المباشراسألوا عن مورّديكم

هل تبنون تطبيقكم أو خلاصة بيانات لشركائكم؟ تقدّم REST API من PHPTRAVELS كل مصادر Stays المتصلة بصيغة واحدة مع Webhooks لأحداث الحجز. وتأتي مع باقة Enterprise، انظروا الأسعار وتوثيق المطورين. والصورة الأوسع في واجهات API للسفر.

الأسئلة الشائعة

API الإقامات: أسئلة المطورين والوكالات

تحدّث مع المبيعات

API الإقامات مجموعة خدمات ويب تتيح لموقع حجز البحث عن الإقامة وقراءة الأسعار والتوفر لتواريخ وضيوف محددين، وإنشاء الحجوزات وقراءتها وإلغاءها. وهو يغطي الفنادق وكل نوع آخر من الإقامة: الشقق وبيوت العطلات والنُّزُل وبيوت الضيافة.

الاستدعاءات الأساسية واحدة. لكن API الإقامات يعالج أيضاً ما تحتاجه الإقامات غير الفندقية: حجز الوحدة كاملة والحد الأدنى للإقامة وأيام التبديل ورسوم الضيوف الإضافيين ورسوم التنظيف والتأمينات المستردة وتعليمات الوصول المرسلة قبل الوصول.

نعم. في PHPTRAVELS تستخدم وحدة Stays نموذجاً واحداً من العقار والوحدة والخطة السعرية والتوفر لكل أنواع الإقامة، فتظهر الفنادق والشقق وبيوت العطلات في البحث نفسه بقواعد كل منها.

يمكن أن تحمل كل ليلة في التقويم حداً أدنى لمدة الإقامة، يرتبط عادةً بتاريخ الوصول. وإذا بحث الضيف عن ليالٍ أقل من الحد الأدنى فلن تُرجَع الوحدة. وتعمل علامات الإغلاق للوصول والإغلاق للمغادرة بالطريقة نفسها لأيام التبديل.

نعم. يمكنكم إضافة العقارات والوحدات والخطط السعرية والتقاويم بأنفسكم، أو منح الملاك حساب إكسترانت، أو استقبال الأسعار من مدير قنوات، وبيعها بجانب مخزون المورّدين في قائمة نتائج واحدة.

من الخطة السعرية. يحمل مخزون المورّدين سياسة المورّد، وتستخدم عقاراتكم الخاصة المهل التي تحددونها. ويُعرض الموعد النهائي للضيف قبل الدفع ويُطبع على القسيمة.

لا. توقّعون مع كل مورّد إقامة وتُدخلون بيانات اعتمادكم في لوحة الإدارة. وتوفّر PHPTRAVELS منصة الحجز ووحدة Stays والموصّلات الجاهزة.

نعم. في باقة Enterprise تتيح REST API من PHPTRAVELS البحث والحجز عبر كل المصادر المتصلة بصيغة واحدة، مع Webhooks لأحداث الحجز وكامل الشيفرة المصدرية للتوسعة.

ترخيص PHPTRAVELS ونطاقكم الخاص ومصدر مخزون واحد على الأقل: عقارات تتعاقدون عليها بأنفسكم، أو مدير قنوات، أو عقد مع تاجر جملة للإقامة. ويعرض العرض المباشر التدفق الكامل أولاً.

واصل الاستكشاف

المزيد عن المنصة