الدعم
تواصل مع فريق المطوّرين لدينا بشأن أي أمر يعيق تكاملك. ننصحك بمراجعة صفحة رموز الأخطاء الخاصة بالمنتج أولًا، ففيها إجابات معظم الأسئلة.
البريد الإلكتروني
الأسئلة التقنية، والإبلاغ عن الأخطاء، وطلبات مفتاح الشريك والفندق التجريبي. نرد خلال يوم عمل واحد.
الهاتف
من الاثنين إلى الجمعة 09:00–18:00 (GMT+3). للأعطال التي تؤثر في بيئة الإنتاج.
مفتاح الشريك
يتطلب الوصول حساب شريك تصدره HMS. أرسل إلينا بريدًا إلكترونيًا يتضمن بيانات شركتك والفنادق التي ستتكامل معها، وستتلقى apiKey وapiSecret ومعرّف فندق لبيئة الاختبار.
عند الإبلاغ عن مشكلة، أرفق
- المنتج ونقطة النهاية (مثل Online Booking ·
POST /external/online/roomType) - متن الطلب الكامل والاستجابة، مع إخفاء
apiSecretوالرمز المميز وبيانات البطاقة - وقت إرسال الطلب (مع المنطقة الزمنية) و
hotelID - النتيجة التي توقعتها، وهل يمكن تكرار المشكلة
الأسئلة الشائعة
ما الذي أحتاجه لاستخدام API؟
حساب شريك صادر عن HMS (apiKey / apiSecret)، وتخويل للوصول إلى الفندق الذي تتكامل معه. ويجب أن تكون الوحدة المعنية (مثل قناة الحجز عبر الإنترنت) مفعّلة لدى الفندق.
هل توجد بيئة اختبار؟
نعم. تستخدم الأمثلة في هذا التوثيق بيئة الاختبار (test.hms.gen.tr)، ونوفّر لك فيها سجل فندق ومفتاح شريك لأغراض التطوير. ويُسلَّم عنوان بيئة الإنتاج ومفاتيحها بعد اعتماد التكامل.
أتلقى الخطأ 401.
الرمز المميز مفقود أو منتهي الصلاحية أو تنقصه البادئة Bearer أو يخص فندقًا آخر. سجّل الدخول مجددًا وأعد المحاولة. إذا أعاد تسجيل الدخول success: false، فراجع message: زوج المفاتيح خاطئ أو لا يوجد تخويل للفندق.
قائمة الغرف فارغة أو قيمة roomCount تساوي 0.
قناة الحجز عبر الإنترنت لدى الفندق مغلقة (errorCode 10003)، أو لا يوجد نوع غرفة متاح للبيع (10004)، أو توجد قيود على التواريخ أو عدد النزلاء. في الغرف التي تكون فيها قيمة roomCount مساوية لـ 0، يوضّح roomRestrictionMessage السبب (الحد الأدنى للإقامة، أو يوم مغلق أمام الوصول، أو عدم تحديد سعر).
أرسلت حجزًا لكنه لا يظهر في لوحة التحكم.
تحقق من وجود Error في BookingPushRS. تعني Hotel registration not found on HMS. أن الفندق غير مرتبط بقناة الحجز عبر الإنترنت؛ وتعني Could not register. عادةً أن roomTypeID / ratePlanID غير صالح أو أن التواريخ غير متسقة.
متى ستُنشر واجهات API للوحدات الأخرى؟
يُضاف توثيق نقاط البيع للمطاعم وSpa والذكاء الاصطناعي وTV والمقسم الهاتفي تباعًا. تُعلَن مواعيد الإصدار في سجل التغييرات؛ راسلنا إذا أردت وصولًا مبكرًا إلى وحدة معيّنة.