עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=deletedrevs (dr)
- יחידה זו אינה מומלצת לשימוש.
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0+
רשימת גרסאות מחוקות.
פועל בשלושה אופנים:
- רשימת גרסאות מחוקות לשמות שניתנו, ממוינות לפי חותם־זמן.
- רשימת תרומות מחוקות של המשתמש שניתן, ממוינות לפי חותם־זמן (בלי לציין שמות).
- רשימת כל הגרסאות המחוקות במרחב השם שניתן, ממוינות לפי שם וחותם־זמן (בלי לציין שמות, בלי להגדיר 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
- ברירת מחדל: 0
- drtag
לרשום רק גרסאות עם התג הזה.
- druser
לרשום רק גרסאות מאת המשתמש הזה.
- סוג: שם משתמש
- drexcludeuser
לא לרשום גרסאות מאת המשתמש הזה.
- סוג: שם משתמש
- drprop
אילו מאפיינים לקבל:
- revid
- הוספת מזהה הגרסה של הגרסה המחוקה.
- parentid
- הוספת מזהה הגרסה של הגרסה הקודמת של הדף.
- user
- הוספת המשתמש שעשה את הגרסה.
- userid
- הוספת מזהה המשתמש שעשה את הגרסה.
- comment
- הוספת ההערה על הגרסה.
- parsedcomment
- הוספת ההערה המפוענחת על הגרסה.
- minor
- מתייג אם הגרסה משנית.
- len
- מוסיף את האורך (בבתים) של הגרסה.
- sha1
- הוספת ה־SHA-1 (בסיס 16) של הגרסה.
- content
- הוספת התוכן של הגרסה.
- token
- מיושן. נותן אסימון עריכה.
- tags
- תגים עבור הגרסה.
- ערכים (מופרדים באמצעות "|"): revid, parentid, user, userid, comment, parsedcomment, minor, len, sha1, content, token, tags
- ברירת מחדל: user|comment
- drlimit
המספר המרבי של הגרסאות שיירשם.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- drcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
דוגמאות:
- רשימת כל הגרסאות המחוקות של הדפים Main Page ו־Talk:Main Page, עם תוכן (mode 1).
- api.php?action=query&list=deletedrevs&titles=Main%20Page|Talk:Main%20Page&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=