تغذية الحجوزات (للمطوّرين)

نقطة النهاية الوحيدة للقراءة التي يعرضها موقع الصالة ليقرأ منها CoinOp الحجوزات.

كيف أربط حجوزات موقعي بـCoinOp؟

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

الاتجاه

CoinOp هو من يسأل. أنت لا تُرسل إلينا شيئًا، ولا تحتاج إلى فتح منفذ، ولا إلى مفتاح يُكتب به على نظامك. صفحة واحدة على موقعك تُعيد قائمة، وCoinOp يقرأها كل بضع دقائق.

وهذا مقصود: التكامل الذي يحتاج إلى كتابة على نظام العميل تكامل يحتاج إلى صلاحيات ومراجعة أمنية ومحادثة مع من يدير موقعه. أما صفحة JSON للقراءة فشيء يبنيه أي مطوّر في ساعة.

الصيغة

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

الأوقات بصيغة ISO 8601 بمنطقة زمنية صريحة. وقت بلا منطقة زمنية يُقرأ بمنطقة الخادم، وهذا يعمل حتى يوم يتغيّر فيه التوقيت أو ينتقل الخادم.

ما الذي يفعله CoinOp بها

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

ونوع ما هو محجوز يُطابَق بأنواع المحطات التي أعددتها في Settings → Stations. نوع لا يُطابق شيئًا يظهر الحجز عليه بلا طاولة مقترحة، بدل أن يُسقَط بصمت.

إن تعذّرت القراءة

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

أما ضبط العنوان وتشغيل المصدر فمن Settings → Bookings، وهناك زر اختبار يخبرك بما قرأه CoinOp من صفحتك — فيُثبَت التكامل على الكاونتر لا عند أول حجز حقيقي.