עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=deletedrevisions (drv)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
קבלת מידע על גרסה מחוקה.
יכול לשמש במספר דרכים:
- קבלת גרסאות מחוקות עבור ערכת דפים, על־ידי הגדרת שמות או מזהי דף. ממוין לפי שם וחותם־זמן.
- קבלת מידע על ערכת גרסאות מחוקות באמצעות הגדרת המזהים שלהם עם 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