كيف يمكننا مساعدتك؟

ParkFlow.io هي منصة مركزية (مدير القنوات) تربط مشغّلي مواقف سيارات المطارات بمختلف قنوات المبيعات كوكالات السفر الإلكترونية (OTAs)، والمجمّعات، والوسطاء، ومواقع B2C. تعمل بوصفها نظام وسيط، يُبسّط إدارة الحجوزات لمواقف السيارات عبر مزامنة الحجوزات والتحديثات والإلغاءات من مصادر متعددة في واجهة موحّدة. يعتمد ParkFlow بشكل أساسي على نموذج تكامل قائم على السحب، حيث يجلب بيانات الحجز بصفة دورية من واجهات برمجة التطبيقات الخاصة بالشركاء.

هذا الدليل موجَّه إلى مزوّدي الخدمات الخارجيين (مثل وكالات السفر الإلكترونية، والوسطاء، والأسواق الإلكترونية) الراغبين في التكامل مع ParkFlow وتوفير حجوزاتهم عبر واجهة برمجة التطبيقات.

نموذج التشغيل

يُشغّل ParkFlow مهام مجدوَلة تسحب الحجوزات الجديدة أو المحدَّثة من واجهة برمجة تطبيقات كل شريك. تُنفَّذ هذه المهام عادةً:

- كل 2–10 دقائق في بيئة الإنتاج
- كل 15–30 دقيقة في وضع الاختبار

يساعد ذلك في ضمان حصول مشغّل موقف السيارات على معلومات محدَّثة حول الوصولات القادمة ومتطلبات الخدمة. 

حالات الاستخدام المشمولة

- جلب الحجوزات المؤكَّدة الجديدة
- اكتشاف تفاصيل الرحلة أو العميل المحدَّثة
- التقاط الإلغاءات
- معالجة التغييرات اللحظية قرب وقت تسجيل الوصول

متطلبات واجهة برمجة التطبيقات

إذا كان لمالك موقف السيارات عروض متعددة (مثل مواقف سيارات أو منتجات مختلفة) في النظام الخارجي، سيُنشئ ParkFlow تكاملاً منفصلاً لكل عرض لضمان دقة التعيين ومزامنة التوفر والتسعير.

لضمان تكامل سلس، يجب على الشركاء الخارجيين توفير واجهة REST API عامة تدعم ما يلي:

المصادقة

يدعم ParkFlow أساليب متعددة:

- Bearer Token: Authorization: Bearer <token>
- Basic Auth: اسم المستخدم وكلمة المرور بترميز base64
- API Key: يُمرَّر في الترويسة (مُفضَّل) أو معامل الاستعلام

ملاحظة: يتم تخزين بيانات الاعتماد وإدارتها بأمان داخل منصة ParkFlow.

نقاط النهاية

يتطلب ParkFlow نقطة نهاية إلزامية واحدة فقط:

GET /bookings – يجب أن تُعيد هذه النقطة قائمةً بجميع الحجوزات التي تم إنشاؤها أو تحديثها أو إلغاؤها منذ نقطة زمنية محددة. يستخدم ParkFlow هذه النقطة لمزامنة البيانات بشكل موثوق من النظام الخارجي.

يجب أن يحتوي كائن الحجز على المعلومات التالية:

- يجب أن تكون تواريخ الوصول والمغادرة بالتوقيت المحلي

- يجب أن تكون تواريخ الإنشاء والتحديث بتوقيت UTC-0

- السعر والمبلغ المدفوع مسبقاً والعملة

- حالة الحجز

- عدد المركبات وأرقام اللوحات

- الرقم المرجعي

نقاط النهاية الاختيارية:

- قفل التوفر

يتيح لـ ParkFlow إبلاغ النظام الخارجي عندما يكون منتج وقوف سيارات معين غير متاح في تواريخ محددة.

مثال:

POST /parkings/{id}/locks

Body: { "date": "2025-07-15", "reason": "full" }

- إشعار حالة الحجز

يتيح لـ ParkFlow إبلاغ النظام الخارجي بإلغاءات الحجوزات أو حالات عدم الحضور التي يبادر بها موقف السيارات.

مثال:

POST /bookings/{id}/cancel

Body: { "reason": "no_show" }

- تحديثات التسعير

 يُمكّن ParkFlow من إرسال بيانات التسعير الموسمي أو الأساسي لعروض وقوف سيارات محددة.

 مثال:

 POST /parkings/{id}/pricing

 Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }

توصيات التكامل

- ضمان دقة الردود وتوقيتها

- تجنّب تخزين البيانات القديمة مؤقتاً

- السماح لـ ParkFlow بضبط تكرار الاستطلاع

- دعم ترقيم الصفحات لأحجام الحجوزات الكبيرة

- توفير بيئة اختبار/تجريب مع بيانات اختبار

متطلبات الأمان

- يجب أن تعمل جميع نقاط النهاية عبر HTTPS

- استخدام أساليب مصادقة آمنة (يُفضَّل القائمة على الرمز المميز)

- تقييد الوصول بناءً على القائمة البيضاء لعناوين IP إن أمكن

- تجنّب تخزين بيانات العملاء الحساسة بما يتجاوز الضرورة