עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=deletedrevs (dr)
- המודול הזה מיושן.
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
רשימת גרסאות מחוקות.
פועל בשלושה אופנים:
- רשימת גרסאות מחוקות לשמות שניתנו, ממוינות לפי חותם־זמן.
- רשימת תרומות מחוקות של המשתמש שניתן, ממוינות לפי חותם־זמן (בלי לציין שמות).
- רשימת כל הגרסאות המחוקות במרחב השם שניתן, ממוינות לפי שם וחותם־זמן (בלי לציין שמות, בלי להגדיר druser).
פרמטרים מסוימים חלים רק על חלק מהאופנים ולא תקפים באחרים.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- drstart
באיזה חותם־זמן להתחיל למנות.
- מצבים: 1, 2
- סוג: חותם־זמן (תסדירים מורשים)
- drend
באיזה חותם־זמן להפסיק למנות.
- מצבים: 1, 2
- סוג: חותם־זמן (תסדירים מורשים)
- drdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת ליבך: drstart חייב להיות לפני drend.
- older
- לרשום את החדשים ביותר בהתחלה (ברירת מחדל). לתשומת ליבך: drstart חייב להיות אחרי drend.
- מצבים: 1, 3
- אחד מהערכים הבאים: newer, older
- ברירת המחדל: older
- drfrom
להתחיל את הרשימה בשם הזה.
- מצב: 3
- drto
להפסיק את הרשימה בכותרת הזאת.
- מצב: 3
- drprefix
חיפוש כל שמות הדפים שמתחילים בערך הזה.
- מצב: 3
- drunique
לרשום רק גרסה אחת עבור כל דף.
- מצב: 3
- סוג: בוליאני (פרטים)
- drnamespace
לרשום רק דפים במרחב השם הזה.
- מצב: 3
- אחד מהערכים הבאים: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 108, 109, 110, 111, 710, 711, 828, 829
- ברירת המחדל: 0
- drtag
לרשום רק גרסאות עם התג הזה.
- druser
לרשום רק גרסאות מאת המשתמש הזה.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- drexcludeuser
לא לרשום גרסאות מאת המשתמש הזה.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- drprop
אילו מאפיינים לקבל:
- revid
- הוספת מזהה הגרסה של הגרסה המחוקה.
- parentid
- הוספת מזהה הגרסה של הגרסה הקודמת של הדף.
- user
- הוספת המשתמש שעשה את הגרסה.
- userid
- הוספת מזהה המשתמש שעשה את הגרסה.
- comment
- הוספת ההערה על הגרסה.
- parsedcomment
- הוספת ההערה המפוענחת על הגרסה.
- minor
- תיוג אם הגרסה משנית.
- len
- מוסיף את האורך (בבתים) של הגרסה.
- sha1
- הוספת ה־SHA-1 (בסיס 16) של הגרסה.
- content
- הוספת תוכן הגרסה. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של drlimit יחויב להיות 50.
- token
- מיושן. נותן אסימון עריכה.
- tags
- תגים עבור הגרסה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, content, len, minor, parentid, parsedcomment, revid, sha1, tags, user, userid, token
- ברירת המחדל: user|comment
- drlimit
המספר המרבי של הגרסאות שיירשם. אם משמש drprop=content, המגבלה היא 50.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 10
- drcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
דוגמאות:
- רשימת כל הגרסאות המחוקות של הדפים עמוד ראשי ו־Talk:Main Page, עם תוכן (mode 1).
- api.php?action=query&list=deletedrevs&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99|%D7%A9%D7%99%D7%97%D7%94%3A%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&drprop=user|comment|content [פתיחה בארגז חול]
- רשימת 50 העריכות המחוקות האחרונות של Bob (mode 2).
- api.php?action=query&list=deletedrevs&druser=Bob&drlimit=50 [פתיחה בארגז חול]
- רשימת 50 הגרסאות המחוקות הראשונות במרחב הראשי (mode 3).
- api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50 [פתיחה בארגז חול]
- רשימת 50 הדפים המחוקים הראשונים במרחב השם שיחה (mode 3).
- api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique= [פתיחה בארגז חול]