עזרה של MediaWiki API

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

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

list=allrevisions (arv)

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

רשימת כל הגרסאות.

פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
arvprop

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

ids
מזהה הגרסה.
flags
דגלי גרסה (משני).
timestamp
חותם־הזמן של הגרסה.
user
המשתמש שעשה את הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
userid
מזהה המשתמש של יוצר הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
size
אורך (בבתים) של הגרסה.
slotsize
אורך (בבתים) של כל משבצת גרסה.
sha1
SHA-1 (בבסיס 16) של הגרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
slotsha1
SHA-1 (בסיס 16) של כל משבצת גרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
contentmodel
מזהה מודל התוכן של כל משבצת גרסה.
comment
הערה מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
parsedcomment
הערה מפוענחת מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
content
התוכן של כל משבצת גרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין texthidden.
tags
התגים עבור הגרסה.
roles
רשימת תפקידי משבצות תוכן שקיימות בגרסה.
parsetree
מיושן. יש להשתמש ב־ action=expandtemplates או ב־ action=parse במקום בזה.

עץ פענוח XML של תוכן הגרסה (דורש מודל תוכן wikitext).

ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
ברירת המחדל: ids|timestamp|flags|comment|user
arvslots

עבור אילו משבצות תוכן להחזיר נתונים, כאשר מאפיינים שקשורים למשבצת כלולים ב־arvprops. אם זה מושמט, נתונים ממשבצת main יוחזרו בתסדיר תואם לאחור.

ערכים (מופרדים באמצעות "|" או or תו חלופי): main
כדי לתת את כל הערכים, יש להשתמש ב־*.
arvlimit

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

סוג: מספר שלם או max
הערך חייב להיות בין 1 ל־500.
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 וצפוי לפלט של תוכן.

אחד מהערכים הבאים: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
arvuser

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

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
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

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

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
arvcontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.

arvgeneratetitles

בעת שימוש בתור מחולל, לחולל כותרת במקום מזהי גרסה.

סוג: בוליאני (פרטים)
דוגמאות:
לרשום את 50 התרומות האחרונות של משתמש Example.
api.php?action=query&list=allrevisions&arvuser=Example&arvlimit=50 [פתיחה בארגז חול]
רשימת 50 הגרסאות הראשונות במרחב שם כלשהו.
api.php?action=query&list=allrevisions&arvdir=newer&arvlimit=50 [פתיחה בארגז חול]