مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
meta=readinglists (rl)
- هذه الوحدة داخلية أو غير مستقرة. قد تتغير عمليتها دون إشعار.
- هذه الوحدة تتطلب صلاحيات القراءة.
- المصدر:ReadingLists
- الترخيص: GPL-2.0-or-later
إدراج أو تصفية قوائم القراءة للمستخدم وإظهار البيانات التعريفية عنها.
هذه الوحدة لديها أربع طرق للتشغيل، باستخدام الوسيط rllist، تقوم بإرجاع معلومات حول القائمة المحددة، مع الوسيط rlchangedsince، فإنها ترجع كافة قوائم المستخدم الحالي والتي تم تغييرها منذ تاريخ معين. (وهذا هو المقصود لمزامنة الجهاز، وعلى عكس وسائل أخرى، تتضمن قوائم محذوفة، تُعتبَر تغييرات إدراج بيانات التعريف فقط، وليست تغييرات على قائمة العناصر.) مع الوسائط rlproject وrltitle، تقوم بإرجاع كافة القوائم التي تتضمن تلك الصفحة، بدون أي من هذه الوسائط، تقوم بإرجاع جميع القوائم.
- rllist
معرف القائمة.
- النوع: 2 = قائمة الأعداد الصحيحة
- 2 = القيم يجب ألا تقل عن 1 .
- rlproject
مشروع الصفحة للتصفية، يجب استخدامه مع rltitle، لن يعرض سوى القوائم التي تتضمن هذا المشروع والعنوان.
- rltitle
عنوان الصفحة للتصفية، يجب استخدامه مع rlproject، لن يعرض سوى القوائم التي تتضمن هذا المشروع والعنوان.
- rlchangedsince
عرض القوائم التي تم تغييرها منذ هذا الطابع الزمني، يجب أن يكون بعد 2024-05-03T10:04:03Z، يجب على العملاء استخدام الطابع الزمني الذي تم إرجاعه في حقل readinglists-synctimestamp من ادعاء سابق إذا كانوا يريدون التأكد من عدم فقدان أية تغييرات، ويجب أن يكونوا مستعدين لتلقي التغييرات التي تم إرجاعها بالفعل في استجابة سابقة، والتعامل معها بطريقة idempotent.
- النوع: timestamp (allowed formats)
- rlsort
خاصية للفرز حسبها، لا يمكن استخدام name مع rlchangedsince (يتم إرجاع النتائج بترتيب DB)، الافتراضي updated عند تعيين rlchangedsince وname على خلاف ذلك.
- name
- اسم القائمة. (يتم الفرز حسب القيمة الثنائية، على سبيل المثال، سيتم فرز أي حرف ASCII كبير قبل أي حرف صغير.)
- updated
- آخر طابع زمني للتحديث. (تتضمن التحديثات تغييرات قائمة بيانات التعريف وليس تغيير عناصر القائمة.)
- إحدى القيم التالية: name، updated
- rldir
اتجاه الفرز: ascending (من الألف إلى الياء، الأقدم إلى الأحدث) أو descending، يتم التجاهل عندما يتم تعيين rlproject وrltitle.
- إحدى القيم التالية: ascending، descending
- الافتراضي: ascending
- rllimit
عدد عناصر النتيجة للعودة.
- النوع: عدد صحيح أو max
- 2 = القيم يجب أن تكون بين 1 10 .
- الافتراضي: 10
- rlcontinue
عندما تتوفر المزيد من النتائج، استخدم هذا للمتابعة
- الحصول على قوائم القراءة للمستخدم الحالي.
- api.php?action=query&meta=readinglists [فتح في ملعب]
- احصل على قوائم القراءة للمستخدم الحالي والتي قد تغيرت منذ 2013-01-01T00:00:00Z.
- api.php?action=query&meta=readinglists&rlchangedsince=2013-01-01T00:00:00Z [فتح في ملعب]
- احصل على قوائم القراءة للمستخدم الحالي والتي تحتوي على الصفحة Dog من المشروع en.wikipedia.org
- api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [فتح في ملعب]