עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

list=readinglistentries (rle)

(main | query | readinglistentries)

המודול הזה פנימי או בלתי־יציב, ולא כדאי לך להשתמש בו. הפעולה שלו יכולה להשתנות ללא הודעה מוקדמת.
יחידה זו דורשת הרשאות קריאה.
אפשר להשתמש ביחידה הזאת בתור מחולל.
מקור: ReadingLists
רישיון: GPL-2.0-or-later

קבלת רשימת הדפים מרשימה מסוימת.

ישנם שני מצבי פעולה עבור המודול הזה. עם הפרמטר rlelists, המודול מחזיר את הדפים ברשימה או ברשימות הנתונות. עם הפרמטר rlechangedsince, המודול מחזיר את כל הערכים מכל הרשימות של המשתמש הנוכחי ששונו מאז התאריך הנתון. (מצב זה נועד לסנכרון בין מכשירים. בניגוד למצבי הפעולה האחרים, מצב זה כולל ערכים שנמחקו, אך אינו כולל ערכים ברשימות שנמחקו.)

https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:ReadingLists#API

פרמטרים ייעודיים:

זמינים פרמטרים כלליים אחרים.

rlelists

מזהי הרשימות שעבורן יוחזרו הדפים.

סוג: רשימת מספרים שלמים

הפרדה בין ערכים נעשית באמצעות | או תו חלופי.

המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).

rlechangedsince

הצגת ערכים ברשימה ששונו מאז התאריך והשעה האלה. המועד חייב להיות אחרי 2024-05-02T14:53:20Z.

סוג: חותם־זמן (תסדירים מורשים)

rlesort

לפי איזה מאפיין למיין את התוצאות. לא ניתן להשתמש ב־name ביחד עם rlechangedsince. ברירת המחדל היא updated כאשר rlechangedsince מוגדר; אחרת, ברירת המחדל היא name.

name: כותרת הערך. (אין משמעות לשם המיזם. המיון נעשה לפי הערך הבינארי; למשל: כל תו ASCII באותיות רישיות יופיע לפני כל תו באותיות קטנות.)
updated: התאריך והשעה של העדכון האחרון.

אחד מהערכים הבאים: name, updated

rledir

סדר המיון: ascending‏ (A עד Z, מהישן לחדש) או descending.

אחד מהערכים הבאים: ascending, descending

ברירת המחדל: ascending

rlelimit

מספר פריטי התוצאות שיוחזרו.

סוג: מספר שלם או max

הערך חייב להיות בין 1 ל־100.

ברירת המחדל: 10

rlecontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.

דוגמאות:

קבלת הדפים מרשימות הקריאה עם המזהים 10, 11 ו־12.: api.php?action=query&list=readinglistentries&rlelists=10|11|12 [פתיחה בארגז חול]
קבלת ערכי הרשימות של המשתמש הנוכחי ששונו מאז 2013-01-01T00:00:00Z.: api.php?action=query&list=readinglistentries&rlechangedsince=2013-01-01T00:00:00Z [פתיחה בארגז חול]