עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=revisions (rv)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
קבלת מידע על גרסה.
יכול לשמש במספר דרכים:
- קבלת נתונים על ערכת דפים (גרסה אחרונה), באמצעות כותרות או מזהי דף.
- קבלת גרסאות עבור דף נתון אחד, באמצעות שימוש בכותרות או במזהי דף עם start, end או limit.
- קבלת נתונים על ערכת גרסאות באמצעות הגדרת המזהים שלהם עם revid־ים.
- rvprop
אילו מאפיינים לקבל עבור כל גרסה:
- 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
- rvlimit
הגבלת מספר הגרסאות שיוחזרו.
- יכול לשמש רק עם דף בודד (mode #2).
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- rvexpandtemplates
להרחיב תבניות בתוכן הגרסה (דורש rvprop=content).
- סוג: בוליאני (פרטים)
- rvgeneratexml
- מיושן.
יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את rvprop=content; מוחלף ב־rvprop=parsetree).
- סוג: בוליאני (פרטים)
- rvparse
פענוח תוכן הגרסה (דורש rvprop=content). מסיבות של ביצועים, אם האפשרות הזאת משמשת, rvlimit נכפה לערך 1.
- סוג: בוליאני (פרטים)
- rvsection
לאחזר רק את התוכן של הפִסקה עם המספר הזה.
- rvdiffto
מזהה הגרסה שאליו תושווה כל גרסה. יש להשתמש ב־prev, next ו־cur עבור הגרסה הקודמת, הבא והנוכחית, בהתאמה.
- rvdifftotext
הטקסט שאליו תושווה כל גרסה. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את rvdiffto. אם מוגדר rvsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה.
- rvcontentformat
תסדיר ההסדרה שמשמש את rvdifftotext וצפוי לפלט של תוכן.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- rvstartid
מאיזה מזהה גרסה להתחיל למנות.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: מספר שלם
- rvendid
באיזה מזהה גרסה להפסיק את מניית הגרסאות.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: מספר שלם
- rvstart
מאיזה חותם־זמן של גרסה להתחיל למנות.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: חותם־זמן (תסדירים מורשים)
- rvend
למנות עד חותם־הזמן הזה.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: חותם־זמן (תסדירים מורשים)
- rvdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת לבך: rvstart חייב להיות לפני rvend.
- older
- לרשום את החדשים ביותר בהתחלה (בררת מחדל). לתשומת לבך: rvstart חייב להיות אחרי rvend.
- יכול לשמש רק עם דף בודד (mode #2).
- אחד מהערכים הבאים: newer, older
- ברירת מחדל: older
- rvuser
לכלול רק גרסאות מאת משתמש.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: שם משתמש
- rvexcludeuser
לא לכלול שינויים מאת משתמש.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: שם משתמש
- rvtag
לרשום רק גרסאות עם התג הזה.
- rvtoken
- מיושן.
אילו אסימונים לקבל עבור כל גרסה.
- ערכים (מופרדים באמצעות "|"): rollback
- rvcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- קבל נתונים על תוכן עבור הגרסאות האחרונות של הכותרות API ו־Main Page.
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content
- קבלת 5 הגרסאות האחרונות של Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment
- קבלת 5 הגרסאות הראשונות של Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer
- קבלת 5 הגרסאות הראשונות של Main Page שנעשו אחרי 2006-05-01.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z
- קבלת 5 הגרבאות הראשונות של Main Page שלא נעשו על־ידי המשתמש האלמוני 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1
- קבלת 5 הגרסאות הראשונות של Main Page שנעשו על־ידי המשתמש MediaWiki default.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default