تخطَّ إلى المحتوى
الموارد

كيف يضيف المطورون حجز الفنادق إلى منتج؟

Section titled “كيف يضيف المطورون حجز الفنادق إلى منتج؟”

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

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

الإجابة المختصرة

تحتاج إلى أربعة أشياء: أسعار وتوافر مباشر، إنشاء الحجز، الدفع، والتأكيد بالإضافة إلى webhooks. تغطي واجهات برمجة التطبيقات التي تقدم محتوى للقراءة فقط الأولى فقط. في Wink، واجهات برمجة التطبيقات للمستهلك ومحرك الحجز مجانية للاستخدام، ويتم إنشاء الحجز عبر REST مع OAuth2، وهناك 70 حدثًا من webhooks بما في ذلك booking.create، ويتم جمع الدفع للفندق — الذي يظل هو التاجر المسجل — لذلك لا تحتاج لأن تصبح تاجرًا. يعرض خادم MCP نفس القدرات لوكلاء الذكاء الاصطناعي، وتغطي مكونات الويب الحالات التي تريد فيها مسار حجز دون بناء واجهة مستخدم.

القدرات الأربعة المهمة

Section titled “القدرات الأربعة المهمة”
القدرةماذا تعنيلماذا تتوقف المنتجات بدونها
أسعار وتوافر مباشرالأسعار الحالية وما هو قابل للحجز فعليًا، حسب نطاق التواريخالأسعار المخزنة مؤقتًا تفشل عند التأكيد وتقلل الثقة
إنشاء الحجزإنشاء حجز حقيقي يستلمه الفندقبدونها أنت مجرد رابط إحالة، وليس منتجًا
الدفعاستلام المال كجزء من الحجزالتحويل إلى موقع آخر هو حيث تموت معدلات التحويل
التأكيد وwebhooksإبلاغ الضيف، الفندق ونظامك بما حدثدعم الحمل والفجوات في التسوية وإلا

معظم “واجهات برمجة تطبيقات الفنادق” التي يجدها المطور تغطي الأولى وأحيانًا الثانية. المعاملة هي الجزء الصعب، وهو الجزء الذي يحدد ما إذا كان لديك منتج.

من هو مزود العرض الذي تدمجه؟

Section titled “من هو مزود العرض الذي تدمجه؟”

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

في أي شيء سيقارن فيه المسافر مع موقع الفندق الخاص — وهو معظم الحالات — العرض الذي يتحكم فيه الفندق يتجنب اللحظة المحرجة عندما يكون سعرك أسوأ.

إذا بنيت حجز الفنادق بنفسك، فإن أن تصبح التاجر المسجل يعني تحمل مسؤولية الدفع، المرتجعات، الاستردادات، التعامل مع الضرائب وغالبًا ترخيص وكالة سفر في كل سوق.

في Wink، يبقى الفندق هو التاجر المسجل ويتم جمع الدفع للفندق، لذلك لا يرث المدمج تلك المسؤولية. ترتيبات التاجر المسجل متاحة في تكاملات API حيث يحتاج الشريك فعليًا إلى استلام الدفع بنفسه، وهذا المسار يحمل متطلبات ترخيص خاصة به.

ثلاثة مستويات من التكامل

Section titled “ثلاثة مستويات من التكامل”
  1. مكونات الويب. أضف بحثًا قابلاً للحجز، قائمة غرف أو إتمام شراء إلى صفحة موجودة. لا حاجة لعمل خلفي؛ أقل تحكم في التخطيط.
  2. REST API. تحكم كامل في البحث، الأسعار، إنشاء الحجز والتأكيد، مع المصادقة عبر OAuth2. استخدمه عندما يكون تدفق الحجز جزءًا من تجربة منتجك.
  3. خادم MCP. نفس القدرات متاحة لوكلاء الذكاء الاصطناعي، بحيث يمكن للمساعد البحث، التسعير وإتمام الحجز بدلاً من تحويل المستخدم إلى موقع ويب.

الثلاثة ليست حصرية — غالبًا ما يستخدم المنتج المكونات لواجهة تسويقية وAPI لتدفقه الأساسي.

  • البحث والتسعير لمدينة واحدة ونطاق تاريخ واحد. احصل على أسعار حقيقية متدفقة قبل تصميم أي شيء.
  • إنشاء حجز اختبار واحد من البداية للنهاية، بما في ذلك الدفع والتأكيد.
  • اشترك في booking.create وأحداث الإلغاء قبل بناء أي واجهة مستخدم فوقها.
  • قرر نموذج النسبة الخاص بك مبكرًا — يجب أن ينتقل سياق المصدر مع الحجز، وإلا سيكون تقريرك تخمينًا لاحقًا.
  • تعامل مع حالات الفشل: فقدان التوافر بين العرض والحجز، رفض الدفع، الاستردادات الجزئية.

التسعير الذي يجب أن يعرفه المطور

Section titled “التسعير الذي يجب أن يعرفه المطور”

واجهات برمجة التطبيقات للمستهلك ومحرك الحجز مجانية. تتضمن واجهة برمجة تطبيقات الشريك بدلًا شهريًا مجانيًا قدره 10,000 ليلة فندقية، ثم يتم الفوترة لكل وحدة. الحجوزات المؤكدة تحمل رسوم منصة الفندق بنسبة 1.5% بالإضافة إلى تكلفة معالجة البطاقة، وتطبق عمولة افتراضية بنسبة 10% عندما يقود منتجك الحجز — وهذا هو كيف يكسب المدمج بدلاً من أن يدفع.

  • البناء على أسعار مخزنة مؤقتًا. تبدو جيدة في التطوير وتفشل في الإنتاج.
  • ترك الدفع لإعادة التوجيه. كل تحويل يفقد حجوزات.
  • تجاهل webhooks حتى الإطلاق. تصبح التسوية وظيفة يدوية.
  • أن تصبح التاجر المسجل بدون حاجة. هو قرار ترخيص ومسؤولية، وليس مجرد قرار تقني.
  • عدم تمرير سياق المصدر. لا يمكن إعادة بناء النسبة بعد ذلك.

استمر في الاستكشاف

أسئلة متكررة حول واجهة برمجة تطبيقات حجز الفنادق

ما الذي يجب دمجه، ما تكلفته، ومن يتحمل مسؤولية الدفع.

ما الذي يجب أن تدعمه واجهة برمجة تطبيقات حجز الفنادق؟
أسعار وتوافر مباشر، إنشاء الحجز، الدفع، والتأكيد مع webhooks. تغطي واجهات برمجة التطبيقات التي تقدم محتوى للقراءة فقط الأولى فقط ولا يمكنها إتمام المعاملة.
هل واجهة برمجة تطبيقات Wink مجانية للاستخدام؟
واجهات برمجة التطبيقات للمستهلك ومحرك الحجز مجانية. تتضمن واجهة برمجة تطبيقات الشريك 10,000 ليلة فندقية مجانية شهريًا، ثم يتم الفوترة لكل وحدة.
هل يجب أن أصبح التاجر المسجل؟
لا. يبقى الفندق هو التاجر المسجل ويتم جمع الدفع للفندق. ترتيبات التاجر المسجل موجودة لتكاملات API التي تحتاج فعليًا لاستلام الدفع بنفسها، مع متطلبات ترخيص خاصة.
هل يمكن لوكلاء الذكاء الاصطناعي الحجز من خلال نفس القدرات؟
نعم. يعرض خادم MCP البحث، التسعير والحجز للوكلاء، بحيث يمكن للمساعد إتمام الحجز بدلاً من تحويل المستخدم إلى موقع ويب.
كيف أحصل على أجر كمندمج؟
تطبق عمولة افتراضية بنسبة 10% على الحجوزات التي قادها منتجك، محسوبة بعد رسوم منصة الفندق ومعالجة البطاقة، مع استمرار النسبة لمدة 6 أشهر لكل نقرة.
هل أحتاج لبناء واجهة مستخدم؟
ليس بالضرورة. توفر مكونات الويب بحثًا قابلاً للحجز، قوائم غرف وإتمام شراء يمكن إضافتها إلى صفحة موجودة؛ وREST API متاحة عندما يجب أن يكون التدفق خاصًا بك.

ابنِ منتجًا يمكنه الحجز فعليًا.

Section titled “ابنِ منتجًا يمكنه الحجز فعليًا.”

عرض فنادق مباشر، إنشاء الحجز عبر REST، webhooks، خادم MCP للوكلاء، ودفع لا تحتاج لامتلاكه.