עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=allrevisions (arv)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
רשימת כל הגרסאות.
- arvprop
אילו מאפיינים לקבל עבור כל גרסה:
- ids
- מזהה הגרסה.
- flags
- דגלי גרסה (משני).
- timestamp
- חותם־הזמן של הגרסה.
- user
- המתמש שעשה את הגרסה
- userid
- מזהה המשתמש של יוצר הגרסה.
- size
- אורך (בבייטים) של הגרסה.
- sha1
- SHA-1 (בבסיס 16) של הגרסה.
- contentmodel
- מזהה מודל התוכן של הגרסה.
- comment
- הערה מאת המשתמש על הגרסה.
- parsedcomment
- הערה מפוענחת מאת המשתמש על הגרסה.
- content
- הטקסט של הגרסה.
- tags
- התגים עבור הגרסה.
- parsetree
- עץ פענוח XML של תוכן הגרסה (דורש מודל תוכן
wikitext).
- ערכים (מופרדים באמצעות "|" או or תו חלופי): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree
- ברירת מחדל: ids|timestamp|flags|comment|user
- arvlimit
הגבלת מספר הגרסאות שיוחזרו.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- arvexpandtemplates
להרחיב תבניות בתוכן הגרסה (דורש arvprop=content).
- סוג: בוליאני (פרטים)
- arvgeneratexml
- מיושן.
יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את arvprop=content; מוחלף ב־arvprop=parsetree).
- סוג: בוליאני (פרטים)
- arvparse
פענוח תוכן הגרסה (דורש arvprop=content). מסיבות של ביצועים, אם האפשרות הזאת משמשת, arvlimit נכפה לערך 1.
- סוג: בוליאני (פרטים)
- arvsection
לאחזר רק את התוכן של הפִסקה עם המספר הזה.
- arvdiffto
מזהה הגרסה שאליו תושווה כל גרסה. יש להשתמש ב־prev, next ו־cur עבור הגרסה הקודמת, הבא והנוכחית, בהתאמה.
- arvdifftotext
הטקסט שאליו תושווה כל גרסה. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את arvdiffto. אם מוגדר arvsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה.
- arvdifftotextpst
ביצוע התמרה לפני שמירה על הטקסט לפני הרצת השוואה. תקף רק כשמשמש עם arvdifftotext.
- סוג: בוליאני (פרטים)
- arvcontentformat
תסדיר ההסדרה שמשמש את arvdifftotext וצפוי לפלט של תוכן.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- arvuser
לרשום רק גרסאות מאת המשתמש הזה.
- סוג: שם משתמש
- arvnamespace
לרשום רק דפים במרחב השם הזה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- arvstart
מאיזה חותם־זמן להתחיל למנות.
- סוג: חותם־זמן (תסדירים מורשים)
- arvend
באיזה חותם־זמן להפסיק למנות.
- סוג: חותם־זמן (תסדירים מורשים)
- arvdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת לבך: arvstart חייב להיות לפני arvend.
- older
- לרשום את החדשים ביותר בהתחלה (בררת מחדל). לתשומת לבך: arvstart חייב להיות אחרי arvend.
- אחד מהערכים הבאים: newer, older
- ברירת מחדל: older
- arvexcludeuser
לא לרשום גרסאות מאת המשתמש הזה.
- סוג: שם משתמש
- arvcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- arvgeneratetitles
בעת שימוש בתור מחולל, לחולל כותרת במקום מזהי גרסה.
- סוג: בוליאני (פרטים)
- לרשום את 50 התרומות האחרונות של משתמש Example.
- api.php?action=query&list=allrevisions&arvuser=Example&arvlimit=50 [פתיחה בארגז חול]
- רשימת 50 הגרסאות הראשונות במרחב הראשי.
- api.php?action=query&list=allrevisions&arvdir=newer&arvlimit=50 [פתיחה בארגז חול]