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

تكامل API للفنادق

تكامل RateHawk API: من مفتاح API إلى حجوزات فندقية فعلية

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

  • موصل RateHawk جاهز
  • ETG API v3
  • استيراد ملفات الفنادق
  • هامش ربحك على الأسعار الصافية

المورّد

ما هو RateHawk، ولماذا تربطه الوكالات

RateHawk هي منصة الحجز B2B التابعة لـ Emerging Travel Group (ETG)، وهي موجهة لوكلاء السفر ومنظمي الرحلات وشركات السفر. يحجز الشركاء الفنادق والشقق وأماكن الإقامة الأخرى بأسعار صافية، إما في بوابة RateHawk نفسها أو عبر واجهة API الخاصة بها.

تُسمّى هذه الواجهة ETG API. إصدارها الحالي هو v3، وهي REST API تعتمد طلبات واستجابات JSON وتغطي البحث والحجز والإلغاء. يوفّر PHPTRAVELS موصل RateHawk ضمن وحدة الإقامة، فتظهر نتائج RateHawk بجانب مورّدي الفنادق الآخرين لديك وعقودك الخاصة.

ذات صلة:الفنادقمحرك حجز الفنادقواجهات API للسفر

بطاقة معلومات المورّد
الشركة
RateHawk، جزء من Emerging Travel Group
النوع
منصة إقامة B2B لمحترفي السفر
المخزون
أكثر من 2.6 مليون خيار إقامة، وفق ما تذكره RateHawk
شركاء API
أكثر من 700 عميل API، وفق ما ذكرته RateHawk في 2024
API
ETG API v3 · REST · JSON
في PHPTRAVELS
موصل جاهز في وحدة الإقامة

مسار الحجز في ETG API v3

كيف يجري حجز RateHawk، مرحلة بعد مرحلة

يمر كل حجز في RateHawk بالمراحل الخمس نفسها. تعرض كل مرحلة استدعاءات ETG API التي تقف خلفها وما يتولاه PHPTRAVELS عنك.

  1. 01

    البحث

    استدعاءات ETG API

    البحث حسب المنطقة · حسب الإحداثيات الجغرافية · حسب معرّفات الفنادق

    PHPTRAVELS

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

  2. 02

    صفحة الفندق

    استدعاءات ETG API

    استرجاع صفحة الفندق

    PHPTRAVELS

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

  3. 03

    الحجز المسبق

    استدعاءات ETG API

    الحجز المسبق للسعر · استرجاع معلومات السعر

    PHPTRAVELS

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

  4. 04

    الحجز

    استدعاءات ETG API

    إنشاء عملية الحجز وبدؤها والتحقق منها

    PHPTRAVELS

    ينشئ الحجز، ويرسل بيانات النزيل، ويتابع الحالة حتى التأكيد، ويحفظ رقم طلب RateHawk.

  5. 05

    بعد الحجز

    استدعاءات ETG API

    استرجاع الحجوزات · إلغاء الحجز · Webhooks الحالة

    PHPTRAVELS

    يرسل القسيمة، ويعرض الحجز في لوحة الإدارة وحساب العميل، وينفّذ الإلغاءات وفق سياسة السعر.

البيانات الثابتة

استورد قاعدة بيانات فنادق RateHawk مرة واحدة، ثم أبقها محدّثة

تحمل نتائج البحث الأسعار فقط. أما الأسماء والعناوين والصور والمرافق والأوصاف فتأتي من البيانات الثابتة لدى ETG، والتي يستوردها PHPTRAVELS إلى صفحات الفنادق لديك.

  • ملف المناطق

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

  • ملف الفنادق

    ملف محتوى الفنادق الكامل: الأسماء والعناوين والإحداثيات والصور والمرافق والأوصاف.

  • الملف التزايدي

    ما تغيّر فقط منذ آخر استيراد، ليبقى الكتالوج محدّثاً دون إعادة تحميل كاملة.

  • ملف التقييمات

    درجات تقييم النزلاء ونصوصها لعرضها في صفحات الفنادق، حيث يشملها اتفاقك.

استيراد محتوى الفنادق
  • ملف المناطق100%
  • ملف الفنادق100%
  • الملف التزايدي64%
  • ملف التقييمات30%

شاشة نموذجية. تعتمد الأعداد على حسابك واللغات.

تقدّم ETG أيضاً Content API لبيانات الفنادق عند الطلب، إلى جانب ملفات البيانات.

مفتاح API وبيئة الاختبار

كيف تعمل المصادقة في RateHawk API

تستخدم ETG API مصادقة HTTP Basic. معرّف المفتاح هو اسم المستخدم ومفتاح API هو كلمة المرور، ويُرسلان عبر HTTPS مع كل طلب.

طلب بحث في بيئة الاختبار (نموذج)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
خادمان
بيئة الاختبار: api-sandbox.ratehawk.com. الاختبار والإنتاج: api.ratehawk.com. خوادم worldota.net القديمة متوقفة الدعم.
الفندق التجريبي حقيقي
لا تسمح مفاتيح الاختبار إلا بحجز الفندق التجريبي ذي hid 8473727، وهذا الحجز حقيقي بمسؤولية مالية حقيقية. ألغِه فور انتهاء الاختبار.
المفاتيح تبقى على الخادم
يحفظ PHPTRAVELS معرّف المفتاح ومفتاح API في إعدادات الخادم، وليس في المتصفح أو التطبيق أبداً.
بلد الإقامة مهم
تعتمد الأسعار على بلد إقامة المسافر، لذلك يرسله الموصل مع كل عملية بحث.

الإعداد في PHPTRAVELS

أعدّ موصل RateHawk في أربع خطوات

لا حاجة إلى كتابة أي كود: يُضبط الموصل من لوحة الإدارة.

  1. 01أضف مفاتيح APIالصق معرّف المفتاح ومفتاح API من RateHawk، أولاً لبيئة الاختبار ثم لاحقاً للإنتاج.
  2. 02استورد قاعدة بيانات الفنادقحمّل ملفي المناطق والفنادق، ثم جدول التحديثات التزايدية.
  3. 03حدّد هامش الربح والعملةهوامش نسبية أو ثابتة، حسب القناة أو مجموعة الوكلاء أو الوجهة، بالعملات التي تبيع بها.
  4. 04اختبر وانطلقنفّذ الحجز والإلغاء التجريبيين، واجتز الاعتماد، ثم انتقل إلى مفاتيح الإنتاج.
المورّدون › RateHawkRateHawk

البيئة

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

معرّف المفتاح4127
مفتاح API••••••••••••••••
هامش الربح12% على الأسعار الصافية
العملةUSD · EUR · GBP
بلد الإقامة الافتراضيGB

شاشة إعدادات نموذجية.

الاعتماد

من الاتفاقية إلى الوصول إلى الإنتاج

لا تفتح RateHawk بيئة الإنتاج إلا بعد توقيع الاتفاقية واجتياز تكاملك لاعتمادها.

  1. 1

    وقّع اتفاقية API

    أنت

    تواصل مع RateHawk بصفتك شركة سفر ووقّع اتفاقية API للأسواق التي تعمل فيها.

  2. 2

    استلم مفاتيح الاختبار

    RateHawk

    تصدر RateHawk معرّف مفتاح ومفتاح API لبيئة الاختبار.

  3. 3

    اربط واستورد

    PHPTRAVELS

    تُدخل المفاتيح في PHPTRAVELS، وتُستورد البيانات الثابتة، وتُحدَّد هوامش الربح.

  4. 4

    اجتز الاعتماد

    RateHawk

    تفحص RateHawk التكامل، بما في ذلك مسار الحجز والحالة والإلغاء.

  5. 5

    الوصول إلى الإنتاج

    أنت

    تُدخل مفاتيح الإنتاج في لوحة الإدارة وتبدأ الحجوزات الفعلية.

بوابة أو API أو محرك

ثلاث طرق لبيع فنادق RateHawk

يستطيع الوكلاء الحجز اليوم على موقع RateHawk نفسه. أما الـ API داخل محرك الحجز الخاص بك فهي ما يضع فنادق RateHawk تحت علامتك التجارية.

  • موقع RateHawk

    من يحجز
    وكلاؤك، حجزاً تلو الآخر
    علامة من
    RateHawk
    ما المطلوب
    التسجيل كوكيل وتسجيل الدخول

  • بناء API بنفسك

    من يحجز
    عملاؤك ووكلاؤك، عبر الإنترنت
    علامة من
    علامتك
    ما المطلوب
    أشهر من التطوير والاعتماد

  • PHPTRAVELS مع RateHawk

    من يحجز
    عملاؤك ووكلاؤك، عبر الإنترنت
    علامة من
    علامتك
    ما المطلوب
    الإعداد واستيراد المحتوى والاعتماد

مورّدون متعددون

RateHawk بجانب مورّدي الفنادق الآخرين لديك

RateHawk مورّد واحد في وحدة الإقامة. يمكن أن يشمل البحث نفسه واجهات API الفندقية الأخرى لديك وعقودك الخاصة، مع هوامش ربح وتوجيه لكل مورّد.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
اطّلع على الأسعارجرّب العرض التجريبي للفنادق

اقرأ دليل الوكلاء

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

أسئلة حول تكامل RateHawk API

ما تسأل عنه الوكالات قبل ربط RateHawk.

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

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

تواصل مع RateHawk بصفتك شركة سفر ووقّع اتفاقية API. بعدها تصدر RateHawk معرّف مفتاح ومفتاح API لبيئة الاختبار، ثم مفاتيح الإنتاج بعد الاعتماد.

وثائق ETG API متاحة على الإنترنت في docs.emergingtravel.com، وتشمل B2B API وContent API وأدلة بيئة الاختبار والاعتماد. لا يوجد ملف PDF منفصل للتنزيل؛ الوثائق الإلكترونية هي الإصدار الحالي.

ETG API هي واجهة API الخاصة بـ Emerging Travel Group، الشركة التي تقف خلف RateHawk. تكامل RateHawk API وتكامل ETG API يعنيان الشيء نفسه؛ والإصدار الحالي هو v3.

PHPTRAVELS ترخيص لمرة واحدة يبدأ من ‏2,499 US$ مع الكود المصدري الكامل، وموصل RateHawk مضمّن في وحدة الإقامة. أما شروطك التجارية مع RateHawk فيُتفق عليها مع RateHawk.

نعم، على api-sandbox.ratehawk.com. لاحظ أن مفاتيح الاختبار لا تسمح إلا بحجز الفندق التجريبي ذي hid 8473727، وهذا الحجز حقيقي، لذا ألغِه فور انتهاء الاختبار.

يسجّل الوكلاء ويدخلون على ratehawk.com للحجز عبر البوابة. أما الوصول إلى API فمنفصل: يستخدم معرّف المفتاح ومفتاح API من اتفاقيتك، وليس بيانات دخولك إلى البوابة.

الموصل موجود بالفعل، لذلك يذهب الوقت إلى الاتفاقية وإضافة المفاتيح واستيراد محتوى الفنادق واعتماد RateHawk، وليس إلى التطوير.

نعم. يخدم الموصل نفسه موقعك B2C وبوابة الوكلاء B2B، مع هوامش ربح منفصلة لكل قناة ومجموعة وكلاء.

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

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

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