עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=alldeletedrevisions (adr)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
רשימת כל הגרסאות המחוקות על־ידי משתמש או במרחב.
- adrprop
אילו מאפיינים לקבל עבור כל גרסה:
- ids
- מזהה הגרסה.
- flags
- דגלי גרסה (משני).
- timestamp
- חותם־הזמן של הגרסה.
- user
- המשתמש שעשה את הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- userid
- מזהה המשתמש של יוצר הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- size
- אורך (בבתים) של הגרסה.
- slotsize
- אורך (בבתים) של כל משבצת גרסה.
- sha1
- SHA-1 (בבסיס 16) של הגרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
- slotsha1
- SHA-1 (בסיס 16) של כל משבצת גרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
- contentmodel
- מזהה מודל התוכן של כל משבצת גרסה.
- comment
- הערה מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- parsedcomment
- הערה מפוענחת מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- content
- התוכן של כל משבצת גרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין texthidden.
- tags
- התגים עבור הגרסה.
- roles
- רשימת תפקידי משבצות תוכן שקיימות בגרסה.
- parsetree
- מיושן. יש להשתמש ב־ action=expandtemplates או ב־ action=parse במקום בזה.
עץ פענוח XML של תוכן הגרסה (דורש מודל תוכן
wikitext
).- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- ברירת המחדל: ids|timestamp|flags|comment|user
- adrslots
עבור אילו משבצות תוכן להחזיר נתונים, כאשר מאפיינים שקשורים למשבצת כלולים ב־adrprops. אם זה מושמט, נתונים ממשבצת main יוחזרו בתסדיר תואם לאחור.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): main
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- adrlimit
להגביל את מספר הגרסאות שיוחזרו.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- adrexpandtemplates
- מיושן.
יש להשתמש ב־action=expandtemplates במקום בזה. לפרוס תבניות בתוכן הגרסה (דורש adrprop=content).
- סוג: בוליאני (פרטים)
- adrgeneratexml
- מיושן.
יש להשתמש ב־action=expandtemplates או ב־action=parse במקום בזה. יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את adrprop=content; מוחלף ב־adrprop=parsetree).
- סוג: בוליאני (פרטים)
- adrparse
- מיושן.
יש להשתמש ב־action=parse במקום בזה. פענוח תוכן הגרסה (דורש adrprop=content). מסיבות של ביצועים, אם האפשרות הזאת משמשת, adrlimit נכפה לערך 1.
- סוג: בוליאני (פרטים)
- adrsection
לאחזר רק את התוכן של הפרק עם המזהה הזה.
- adrdiffto
- מיושן.
יש להשתמש ב־action=compare במקום בזה. מזהה הגרסה שכל גרסה תושווה אליה. יש להשתמש ב־prev, next ו־cur עבור הגרסה הקודמת, הבא והנוכחית, בהתאמה.
- adrdifftotext
- מיושן.
יש להשתמש ב־action=compare במקום בזה. הטקסט שכל גרסה גרסה תושווה אליו. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את adrdiffto. אם מוגדר adrsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה.
- adrdifftotextpst
- מיושן.
יש להשתמש ב־action=compare במקום בזה. ביצוע התמרה לפני שמירה על הטקסט לפני הרצת השוואה. תקף רק כשמשמש עם adrdifftotext.
- סוג: בוליאני (פרטים)
- adrcontentformat
- מיושן.
תסדיר ההסדרה שמשמש את adrdifftotext וצפוי לפלט של תוכן.
- אחד מהערכים הבאים: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- adruser
לרשום רק גרסאות מאת המשתמש הזה.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- adrnamespace
לרשום רק דפים במרחב השם הזה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 100, 101, 710, 711, 828, 829, 2300, 2301, 2302, 2303
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- adrstart
מאיזה חותם־זמן להתחיל למנות.
- יכול לשמש רק adruser.
- סוג: חותם־זמן (תסדירים מורשים)
- adrend
באיזה חותם־זמן להפסיק למנות.
- יכול לשמש רק adruser.
- סוג: חותם־זמן (תסדירים מורשים)
- adrdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת ליבך: adrstart חייב להיות לפני adrend.
- older
- לרשום את החדשים ביותר בהתחלה (ברירת מחדל). לתשומת ליבך: adrstart חייב להיות אחרי adrend.
- אחד מהערכים הבאים: newer, older
- ברירת המחדל: older
- adrfrom
להתחיל את הרשימה בשם הזה.
- לא יכול לשמש עם adruser.
- adrto
להפסיק את הרשימה בכותרת הזאת.
- לא יכול לשמש עם adruser.
- adrprefix
חיפוש כל שמות הדפים שמתחילים בערך הזה.
- לא יכול לשמש עם adruser.
- adrexcludeuser
לא לרשום גרסאות מאת המשתמש הזה.
- לא יכול לשמש עם adruser.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- adrtag
לרשום רק גרסאות עם התג הזה.
- adrcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
- adrgeneratetitles
בעת שימוש בתור מחולל, לחולל כותרת במקום מזהי גרסה.
- סוג: בוליאני (פרטים)
- לרשום את 50 התרומות המחוקות האחרונות של משתמש Example.
- api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50 [פתיחה בארגז חול]
- רשימת 50 הגרסאות המחוקות הראשונות במרחב הראשי.
- api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrnamespace=0&adrlimit=50 [פתיחה בארגז חול]