עזרה של MediaWiki 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
מזהה הרשימה.
- סוג: מספר שלם
- הערך לא יכול להיות קטן מ־1.
- rlproject
מיזם הדף שבו יתבצע הסינון. שדה זה חייב להיות בשימוש יחד עם rltitle. יוחזרו רק רשימות הכוללות את המיזם ואת הכותרת הללו.
- rltitle
כותרת הדף שבו יתבצע הסינון. שדה זה חייב להיות בשימוש יחד עם rlproject. יוחזרו רק רשימות הכוללות את המיזם ואת הכותרת הללו.
- rlchangedsince
הצגת רשימות ששונו מאז התאריך והשעה האלה. המועד חייב להיות אחרי 2024-10-15T16:40:25Z. יש להשתמש בתאריך ובשעה שהוחזרו בשדה readinglists-synctimestamp בקריאה קודמת, אם ברצונך לוודא שאין שינויים חסרים. כמו־כן, יתקבלו שינויים שכבר הוחזרו בתשובה קודמת, ויש לטפל בהם באופן אידמפוטנטי.
- סוג: חותם־זמן (תסדירים מורשים)
- rlsort
לפי איזה מאפיין למיין את התוצאות. לשדה זה אין משמעות כאשר rlproject ו־rltitle מוגדרים (במקרה כזה התוצאות מוחזרות בסדר של בסיס הנתונים). ברירת המחדל היא updated כאשר rlchangedsince מוגדר; אחרת, ברירת המחדל היא name.
- name
- שם הרשימה. (המיון נעשה לפי הערך הבינארי; למשל: כל תו ASCII באותיות רישיות יופיע לפני כל תו באותיות קטנות.)
- updated
- התאריך והשעה של העדכון האחרון. (העדכונים כוללים שינויים במטא־הנתונים של הרשימה, אך אינם כוללים שינויים בפריטי הרשימה.)
- אחד מהערכים הבאים: name, updated
- rldir
סדר המיון: ascending (A עד Z, מהישן לחדש) או descending. לשדה זה אין משמעות כאשר rlproject ו־rltitle מוגדרים.
- אחד מהערכים הבאים: ascending, descending
- ברירת המחדל: ascending
- rllimit
מספר פריטי התוצאות שיוחזרו.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־10.
- ברירת המחדל: 10
- rlcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
- קבלת רשימות הקריאה של המשתמש הנוכחי.
- 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 [פתיחה בארגז חול]