עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=allrevisions (arv)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
רשימת כל הגרסאות.
- arvprop
אילו מאפיינים לקבל עבור כל גרסה:
- ids
- מזהה הגרסה.
- flags
- דגלי גרסה (משני).
- timestamp
- חותם־הזמן של הגרסה.
- user
- המשתמש שעשה את הגרסה
- userid
- מזהה המשתמש של יוצר הגרסה.
- size
- אורך (בבייטים) של הגרסה.
- sha1
- SHA-1 (בבסיס 16) של הגרסה.
- contentmodel
- מזהה מודל התוכן של הגרסה.
- comment
- הערה מאת המשתמש על הגרסה.
- parsedcomment
- הערה מפוענחת מאת המשתמש על הגרסה.
- content
- הטקסט של הגרסה.
- tags
- התגים עבור הגרסה.
- parsetree
- מיושן. יש להשתמש ב־ action=expandtemplates או ב־ action=parse במקום בזה.
עץ פענוח 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
- מיושן.
יש להשתמש ב־action=expandtemplates במקום בזה. להרחיב תבניות בתוכן הגרסה (דורש arvprop=content).
- סוג: בוליאני (פרטים)
- arvgeneratexml
- מיושן.
יש להשתמש ב־action=expandtemplates או ב־action=parse במקום בזה. יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את arvprop=content; מוחלף ב־arvprop=parsetree).
- סוג: בוליאני (פרטים)
- arvparse
- מיושן.
יש להשתמש ב־action=parse במקום בזה. פענוח תוכן הגרסה (דורש arvprop=content). מסיבות של ביצועים, אם האפשרות הזאת משמשת, arvlimit נכפה לערך 1.
- סוג: בוליאני (פרטים)
- arvsection
לאחזר רק את התוכן של הפִסקה עם המספר הזה.
- arvdiffto
- מיושן.
יש להשתמש ב־action=compare במקום בזה. מזהה הגרסה שכל גרסה תושווה אליה. יש להשתמש ב־prev, next ו־cur עבור הגרסה הקודמת, הבא והנוכחית, בהתאמה.
- arvdifftotext
- מיושן.
יש להשתמש ב־action=compare במקום בזה. הטקסט שכל גרסה גרסה תושווה אליו. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את arvdiffto. אם מוגדר arvsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה.
- arvdifftotextpst
- מיושן.
יש להשתמש ב־action=compare במקום בזה. ביצוע התמרה לפני שמירה על הטקסט לפני הרצת השוואה. תקף רק כשמשמש עם arvdifftotext.
- סוג: בוליאני (פרטים)
- arvcontentformat
תסדיר ההסדרה שמשמש את arvdifftotext וצפוי לפלט של תוכן.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- arvuser
לרשום רק גרסאות מאת המשתמש הזה.
- סוג: שם משתמש
- arvnamespace
לרשום רק דפים במרחב השם הזה.
לתשומת לבך: בשל מצב חיסכון, שימוש בזה יכול להוביל לפחות מ־arvlimit תוצאות לפני המשך; במצבים קיצוניים ייתכן שיחזרו אפס תוצאות.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 102, 103, 106, 107, 108, 109
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- 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 [פתיחה בארגז חול]