للمطورين

يمنح "من الأشهر اليوم" واجهة للإستعلام للمطورين، تتيح الواجهة جزء من البيانات المعروضة من خلال الموقع، يمكن استهلاك الواجهة من خلال طلب نفس الصفحة التى تظهر للمستخدم ولكن مع تحديد request header لطلب نوع مختلف من الرد، تقوم المتصفحات بإستهلاك المتصفح من خلال ارسال "ِِAccept-response: text/html" مما ينتج البيانات من نوعية HTML ، يستجيب الموقع لنوع بيانات "application/json" ايضأ حيث يكون الرد من نوعية "JSON" ومطابقأ للمواصفات القياسية JSONAPI.

لا تستجيب كل صفحات "من الأشهر اليوم" لنوعية بيانات "JSON" فقط بعض الصفحات كالصفحة التالية :

GET https://www.whoispopulartoday.com/day

ويمكن طلب نوع بيانات json ب3 طرق، إما بإلحاق ".json" بنهاية الصفحة او بإرسال header مع الطلب، او ارسال format parameter مع الطلب:

curl -H "Accept: application/json" https://www.whoispopulartoday.com/day curl https://www.whoispopulartoday.com/day.json curl https://www.whoispopulartoday.com/day?format=json

تستجيب كل الendpoints التالية للطرق الثلاث، قم بإستخدام الطريقة التى تتناسب مع احتياجاتك.

الصفحات التى تستجيب لنوعية بيانات JSON

  • الصفحة الرئيسية GET https://www.whoispopulartoday.com وفى حالة استخدام لاحقة ".json" يرجى اضافة "day" لنهاية الطلب كالمثال السابق

  • صفحة قائمة المشاهير فى يوم محدد GET https://www.whoispopulartoday.com/day/YYYY-mm-dd تقوم بإرجاع قائمة من الشخصيات خلال يوم محدد ويكون بالتنسيق YYYY-mm-dd مثل 2016-08-02

  • صفحة البحث عن الشخصيات GET https://www.whoispopulartoday.com/people/search?query=person_name تقوم بإرجاع قائمة بالشخصيات التى تحتوى على قيمة query

  • قائمة الدول GET https://www.whoispopulartoday.com/countries تقوم بعرض قائمة الدول المدعومة من النظام ويمكن استخدام كود الدولة للحصول على نتائج خاصة بتلك الدولة من جميع الصفحات الاخرى من خلال ارسال كود الدولة كقيمة ل "country" parameter

قواعد عامة لإستخدام الواجهة البرمجية

  • يرجى عدم اساءة استخدام الواجهة البرمجية بإرسال الكثير من الطلبات او محاولة تحميل اكبر قدر من البيانات.
  • الواجهة البرمجية عرضة للrate limiting بحسب المستخدم فيرجى استخدام الAPI من خلال جانب المستخدم وليس جانب الخادم، حيث ستكون اقل عرضة لإيقاف طلباتك إن زادت عن الحد المسموح به.
  • الواجهة البرمجية عرضة للتغيير و التحسين فيرجى الأخذ فى الحسبان التحديث التلقائى لتطبيقك على اجهزة العملاء مع اى نسخة جديدة فى اسرع وقت ممكن حيث ان بعض التغييرات يمكنها ايقاف عمل تطبيقك تماما.
Chrome إضافة "من الأشهر اليوم" لمتصفح جوجل كروم يمكنها تنبيهك بأهم الشخصيات التى تظهر فى الصحف بشكل دورى بطريقة اسرع من متابعة مواقع الأخبار من حين لأخر.
تنزيل الإضافة من متجر جوجل كروم إغلاق التنبيه
Firefox إضافة "من الأشهر اليوم" لمتصفح فايرفوكس يمكنها تنبيهك بأهم الشخصيات التى تظهر فى الصحف بشكل دورى بطريقة اسرع من متابعة مواقع الأخبار من حين لأخر.
تنزيل الإضافة من متجر فايرفوكس إغلاق التنبيه
Opera إضافة "من الأشهر اليوم" لمتصفح أوبرا يمكنها تنبيهك بأهم الشخصيات التى تظهر فى الصحف بشكل دورى بطريقة اسرع من متابعة مواقع الأخبار من حين لأخر.
تنزيل الإضافة الرسمية إغلاق التنبيه