روح للمحتوى على طول
إزاز للمطورين

بيع ملاعب البادل من جوه تطبيقك، لحظة بلحظة

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

الـ API بيعمل إيه

  • بيجيبلك الأماكن اللي سامحالك تبيع ملاعبها، ومع كل ملعب تفاصيله وصوره وتقييمه وملخص الأمان بتاعه.
  • بيوريك المواعيد الفاضية وأسعارها لكل ملعب في يوم بتوقيت القاهرة (٦٠ أو ٩٠ أو ١٢٠ دقيقة، من أي نص ساعة).
  • بيحجز ويلغي الملاعب للاعيبتك، وتقدر تعيد الطلب بأمان بمفتاح Idempotency، والحجز مربوط بالمرجع بتاعك.
  • بيوريك باقات وعضويات اللاعب في المكان، علشان يقدر يدفع من دقايق الباقة.
  • بيخلّي لاعيبتك يقيّموا الملعب بعد ما يلعبوا، وبيقولّك لما المكان يرد.
  • بيخلّي لاعيبتك يبلّغوا عن مشكلة أمان في الملعب بالصور، وبيقولّك لما المكان يحلها.
  • بيبلّغ السيرفر بتاعك بكل تغيير عن طريق webhooks متوقّعة.

القواعد، بالبلدي

القواعد دي جاية من الأماكن ومن القانون المصري. الـ API بيطبّقها، وتطبيقك لازم يشرحها للاعيبة.

إزاز عمره ما بيمسك فلوس اللاعيبة

كل حجز بيقول هيتدفع إزاي: PAY_AT_VENUE (اللاعب يدفع في ريسبشن المكان، وخصم عضويته بيتحسب)، أو PREPAID_BY_PARTNER (إنت حصّلت الفلوس في تطبيقك، وتبعت المبلغ اللي حصّلته في collected، وتتحاسب مع المكان على سعر الملعب، وده بيظهر في كشف حساب الشركاء بتاع المكان)، أو PACKAGE (من دقايق باقة اللاعب في المكان ده، وبترجع لو الحجز اتلغى). الباقة بتدفع بس لما تبعت customer.phoneVerified بـ true: يعني إنت بتأكد إن اللاعب أثبتلك إن الرقم ده بتاعه، بكود مثلًا. إزاز بتسجّل ده مع الحجز.

المكان بيشوف اسم اللاعب ورقمه

اللاعيبة ملهمش حساب على إزاز: هما عملاءك إنت. مع كل حجز بتبعت اسم اللاعب ورقم الموبايل اللي إنت اتأكدت منه، بصيغة E.164 (+201001234567). المكان بيشوف الاتنين على الحجز وفي قايمة عملائه، فلازم تقول للاعيبتك إن المكان بيوصله اسمهم ورقمهم. إزاز بيعالج البيانات دي بالنيابة عنك باتفاقية معالجة بيانات (قانون حماية البيانات الشخصية المصري ١٥١ لسنة ٢٠٢٠).

الأماكن اللي اختارتك بس

المكان هو اللي بيقرر أنهي تطبيقات تبيع ملاعبه. إنت بتشوف الأماكن الشغالة اللي سمحت لتطبيقك بس، وحجوزاتك وتقييماتك وبلاغاتك إنت بس؛ أي حاجة غير كده بترجع 404.

التقييم من التطبيق اللي حجز

التطبيق اللي عمل الحجز هو بس اللي يقدر يقيّمه، بعد ما يتلعب، وخلال ١٤ يوم من نهايته، ومرة واحدة. لو بعت نفس التقييم تاني هيرجعلك هو؛ ولو بعت تقييم مختلف هيترفض.

الإلغاء بمعاد المكان

تقدر تلغي ببلاش لحد معاد الإلغاء بتاع المكان (cancellationHours في كل مكان). بعد كده المكان بس هو اللي يقدر يلغي.

بلاغ الأمان عن الملعب

البلاغ بيقول إيه المشكلة في الملعب: من غير أي تفاصيل طبية ولا أسامي حد اتعور. المكان عمره ما بيعرف مين اللي بلّغ، واللاعب يقدر يبعت ٥ بلاغات بالكتير في اليوم عن طريقك.

الربط بيمشي إزاي

  1. اطلب صلاحية. إزاز بيسجّل تطبيقك ويديك client id وclient secret بيظهر مرة واحدة بس.
  2. السيرفر بتاعك ياخد توكن صالح ١٠ دقايق بطريقة OAuth 2.0 client credentials.
  3. اقرا الأماكن اللي سمحتلك، وملاعبها، والمواعيد الفاضية.
  4. احجز للاعب، وخليك متزامن عن طريق الـ webhooks.