עזרה של MediaWiki API

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

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

prop=deletedrevisions (drv)

(main | query | deletedrevisions)
  • יחידה זו דורשת הרשאות קריאה.
  • אפשר להשתמש ביחידה הזאת בתור מחולל.
  • מקור: MediaWiki
  • רישיון: GPL-2.0+

קבלת מידע על גרסה מחוקה.

יכול לשמש במספר דרכים:

  1. קבלת גרסאות מחוקות עבור ערכת דפים, על־ידי הגדרת שמות או מזהי דף. ממוין לפי שם וחותם־זמן.
  2. קבלת מידע על ערכת גרסאות מחוקות באמצעות הגדרת המזהים שלהם עם revid־ים. ממוין לפי מזהה גרסה.
פרמטרים:
drvprop

אילו מאפיינים לקבל עבור כל גרסה:

ids
מזהה הגרסה.
flags
דגלי גרסה (משני).
timestamp
חותם־הזמן של הגרסה.
user
המתמש שעשה את הגרסה
userid
מזהה המשתמש של יוצר הגרסה.
size
אורך (בבתים) של הגרסה.
sha1
SHA-1 (בבסיס 16) של הגרסה.
contentmodel
מזהה מודל התוכן של הגרסה.
comment
הערה מאת המשתמש על הגרסה.
parsedcomment
הערה מפוענחת מאת המשתמש על הגרסה.
content
הטקסט של הגרסה.
tags
התגים עבור הגרסה.
parsetree
עץ פענוח XML של תוכן הגרסה (דורש מודל תוכן wikitext).
ערכים (מופרדים באמצעות "|"): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree
ברירת מחדל: ids|timestamp|flags|comment|user
drvlimit

הגבלת מספר הגרסאות שיוחזרו.

המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
סוג: מספר שלם או max
drvexpandtemplates

להרחיב תבניות בתוכן הגרסה (דורש drvprop=content).

סוג: בוליאני (פרטים)
drvgeneratexml
מיושן.

יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את drvprop=content; מוחלף ב־drvprop=parsetree).

סוג: בוליאני (פרטים)
drvparse

פענוח תוכן הגרסה (דורש drvprop=content). מסיבות של ביצועים, אם האפשרות הזאת משמשת, drvlimit נכפה לערך 1.

סוג: בוליאני (פרטים)
drvsection

לאחזר רק את התוכן של הפִסקה עם המספר הזה.

drvdiffto

מזהה הגרסה שאליו תושווה כל גרסה. יש להשתמש ב־prev‏, next ו־cur עבור הגרסה הקודמת, הבא והנוכחית, בהתאמה.

drvdifftotext

הטקסט שאליו תושווה כל גרסה. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את drvdiffto. אם מוגדר drvsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה.

drvcontentformat

תסדיר ההסדרה שמשמש את drvdifftotext וצפוי לפלט של תוכן.

אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
drvstart

מאיזה חותם־זמן להתחיל למנות. לא תקף בעיבוד רשימת מזהי גרסה.

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

באיזה חותם־זמן להפסיק למנות. לא תקף בעת עיבוד רשימת מזהי גרסה.

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

באיזה כיוון למנות:

newer
לרשום את הישנים ביותר בהתחלה. לתשומת לבך: drvstart חייב להיות לפני drvend.
older
לרשום את החדשים ביותר בהתחלה (בררת מחדל). לתשומת לבך: drvstart חייב להיות אחרי drvend.
אחד מהערכים הבאים: newer, older
ברירת מחדל: older
drvtag

לרשום רק גרסאות עם התג הזה.

drvuser

לרשום רק גרסאות מאת המשתמש הזה.

סוג: שם משתמש
drvexcludeuser

לא לרשום גרסאות מאת המשתמש הזה.

סוג: שם משתמש
drvcontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.

דוגמאות:
רשימת גרסאות מחוקות של הדפים Main Page ו־Talk:Main Page, עם תוכן.
api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvprop=user|comment|content
קבלת מידע לגרסה המחוקה 123456.
api.php?action=query&prop=deletedrevisions&revids=123456