يا هلا بكم يا شباب في معهد ديف بوينت. كـ Developers وباحثين عن أفكار مشاريع سريعة ومفيدة، كثيراً ما نحتاج للتعامل مع واجهات برمجة التطبيقات (APIs) التي تقدم بيانات في الوقت الفعلي (Real-time). سنستعرض في هذا الشرح طريقة التعامل مع واجهة API خفيفة توفر نتائج السحب واليانصيب المباشرة، وتستجيب ببيانات منسقة بصيغة JSON، مما يسهل دمجها في تطبيقات الموبايل أو المواقع الإلكترونية أو حتى السكريبتات البرمجية.
كيفية عمل واجهة البرمجة (API Endpoints)
تعتمد الواجهة البرمجية على إرسال طلبات بسيطة عبر بروتوكول HTTP باستخدام طريقة GET، وتوفر مسارين رئيسيين للحصول على البيانات حسب نوع السحب المطلوب:
المعاملات المقبولة في الاستعلام (Query Parameters)
لطلب البيانات المطلوبة بدقة، يتم إرفاق المعاملات التالية ضمن رابط الطلب:
تحليل استجابة API وصيغة JSON
1. فحص حالة السحب (Sorteo Status)
عند إرسال طلب فحص الحالة بالشكل التالي:
ترد الخدمة بكائن JSON يوضح حالة السحب وشجرة الأخطاء إن وجدت:
2. الاستعلام عن ملخص الأرقام الفائزة
للحصول على ملخص بأهم الأرقام الفائزة بالجوائز الأولى، يتم تمرير المعامل n بالقيمة resumen:
وتكون الاستجابة منسقة كالتالي:
3. الاستعلام عن رقم محدد
للتحقق من قيمة الجائزة الخاصة برقم معين، يتم تمرير الرقم المباشر في المعامل n:
وتكون الاستجابة موضحة لمبلغ الجائزة المستحقة:
إرشادات الاستخدام والربط المتقدم
توضح هذه التجربة البرمجية مدى سهولة التعامل مع واجهات REST APIs واستخراج البيانات منها باستخدام مختلف لغات البرمجة مثل Python أو PHP أو JavaScript. هل تفضلون الاعتماد على خدمات الكاش المحلية عند بناء تطبيق يستند إلى APIs خارجية؟ شاركونا تجاربكم وأسئلتكم في التقييمات والردود!
كيفية عمل واجهة البرمجة (API Endpoints)
تعتمد الواجهة البرمجية على إرسال طلبات بسيطة عبر بروتوكول HTTP باستخدام طريقة GET، وتوفر مسارين رئيسيين للحصول على البيانات حسب نوع السحب المطلوب:
كود:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
المعاملات المقبولة في الاستعلام (Query Parameters)
لطلب البيانات المطلوبة بدقة، يتم إرفاق المعاملات التالية ضمن رابط الطلب:
- المعامل s (حالة السحب Status): يتم إرسال القيمة 1 للحصول على الحالة الحالية للسحب ومدى اعتماده.
- المعامل t (الختم الزمني Timestamp): يتم إرسال القيمة 1 لمعرفة وقت آخر تحديث تم على البيانات بصيغة Unix Timestamp.
- المعامل n (رقم بطاقة السحب): يقبل القيمة الرقمية للبطاقة المراد فحصها (من 0 إلى 99999) لمعرفة قيمة الجائزة، أو القيمة النصية "resumen" للحصول على قائمة بالأرقام الفائزة بالجوائز الكبرى.
تحليل استجابة API وصيغة JSON
1. فحص حالة السحب (Sorteo Status)
عند إرسال طلب فحص الحالة بالشكل التالي:
كود:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
ترد الخدمة بكائن JSON يوضح حالة السحب وشجرة الأخطاء إن وجدت:
JSON:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
2. الاستعلام عن ملخص الأرقام الفائزة
للحصول على ملخص بأهم الأرقام الفائزة بالجوائز الأولى، يتم تمرير المعامل n بالقيمة resumen:
كود:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
وتكون الاستجابة منسقة كالتالي:
JSON:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
3. الاستعلام عن رقم محدد
للتحقق من قيمة الجائزة الخاصة برقم معين، يتم تمرير الرقم المباشر في المعامل n:
كود:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
وتكون الاستجابة موضحة لمبلغ الجائزة المستحقة:
JSON:
من فضلك قم , تسجيل الدخول أو تسجيل لعرض المحتوى
إرشادات الاستخدام والربط المتقدم
توضح هذه التجربة البرمجية مدى سهولة التعامل مع واجهات REST APIs واستخراج البيانات منها باستخدام مختلف لغات البرمجة مثل Python أو PHP أو JavaScript. هل تفضلون الاعتماد على خدمات الكاش المحلية عند بناء تطبيق يستند إلى APIs خارجية؟ شاركونا تجاربكم وأسئلتكم في التقييمات والردود!
