עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת מידע על גרסה.
יכול לשמש בכמה דרכים:
- קבלת נתונים על ערכת דפים (גרסה אחרונה), באמצעות כותרות או מזהי דף.
- קבלת גרסאות עבור דף נתון אחד, באמצעות שימוש בכותרות או במזהי דף עם start, end או limit.
- קבלת נתונים על ערכת גרסאות באמצעות הגדרת המזהים שלהם עם revid־ים.
- rvprop
אילו מאפיינים לקבל עבור כל גרסה:
- 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. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של rvlimit יחויב להיות 50.
- tags
- התגים עבור הגרסה.
- roles
- רשימת תפקידי משבצות תוכן שקיימות בגרסה.
- parsetree
- מיושן. יש להשתמש ב־ action=expandtemplates או ב־action=parse במקום בזה. עץ פענוח ה־XML של תוכן הגרסה (דורש מודל תוכן
wikitext). מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של rvlimit יחויב להיות 50.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- ברירת המחדל: ids|timestamp|flags|comment|user
- rvslots
עבור אילו משבצות תוכן להחזיר נתונים, כאשר מאפיינים שקשורים למשבצת כלולים ב־rvprops. אם זה מושמט, נתונים ממשבצת main יוחזרו בתסדיר תואם לאחור.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): main
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- rvcontentformat-{slot}
תסדיר להסדרת תוכן שמשמש לפלט תוכן.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר rvslots.
- אחד מהערכים הבאים: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- rvlimit
להגביל כמה גרסאות יוחזרו. אם משמש rvprop=content, rvprop=parsetree, rvdiffto או rvdifftotext, המגבלה היא 50. אם משמש rvparse, המגבלה היא 1.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- rvexpandtemplates
- מיושן.
יש להשתמש ב־action=expandtemplates במקום בזה. לפרוס תבניות בתוכן הגרסה (דורש rvprop=content).
- סוג: בוליאני (פרטים)
- rvgeneratexml
- מיושן.
יש להשתמש ב־action=expandtemplates או ב־action=parse במקום בזה. יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את rvprop=content; מוחלף ב־rvprop=parsetree).
- סוג: בוליאני (פרטים)
- rvparse
- מיושן.
יש להשתמש ב־action=parse במקום בזה. פענוח תוכן הגרסה (דורש rvprop=content). מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של rvlimit יחויב להיות 1.
- סוג: בוליאני (פרטים)
- rvsection
לאחזר רק את התוכן של הפרק עם המזהה הזה.
- rvdiffto
- מיושן.
יש להשתמש ב־action=compare במקום בזה. מזהה הגרסה שכל גרסה תושווה אליה. יש להשתמש ב־prev, next ו־cur עבור הגרסה הקודמת, הבאה והנוכחית, בהתאמה. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של rvlimit יחויב להיות 50.
- rvdifftotext
- מיושן.
יש להשתמש ב־action=compare במקום בזה. הטקסט שכל גרסה גרסה תושווה אליו. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את rvdiffto. אם מוגדר rvsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של rvlimit יחויב להיות 50.
- rvdifftotextpst
- מיושן.
יש להשתמש ב־action=compare במקום בזה. ביצוע התמרה לפני שמירה על הטקסט לפני הרצת השוואה. תקף רק כשמשמש עם rvdifftotext.
- סוג: בוליאני (פרטים)
- rvcontentformat
- מיושן.
תסדיר ההסדרה שמשמש את rvdifftotext וצפוי לפלט של תוכן.
- אחד מהערכים הבאים: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- 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).
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- rvexcludeuser
לא לכלול שינויים מאת משתמש.
- יכול לשמש רק עם דף בודד (mode #2).
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- rvtag
לרשום רק גרסאות עם התג הזה.
- rvcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
- קבלת נתונים על תוכן עבור הגרסאות האחרונות של הכותרת API והכותרת עמוד ראשי.
- api.php?action=query&prop=revisions&titles=API|%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvslots=*&rvprop=timestamp|user|comment|content [פתיחה בארגז חול]
- קבלת 5 הגרסאות האחרונות של הדף עמוד ראשי.
- api.php?action=query&prop=revisions&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvlimit=5&rvprop=timestamp|user|comment [פתיחה בארגז חול]
- קבלת 5 הגרסאות הראשונות של הדף עמוד ראשי.
- api.php?action=query&prop=revisions&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [פתיחה בארגז חול]
- קבלת 5 הגרסאות הראשונות של הדף עמוד ראשי שנעשו אחרי 2006-05-01.
- api.php?action=query&prop=revisions&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [פתיחה בארגז חול]
- קבלת 5 הגרבאות הראשונות של דף עמוד ראשי שלא נעשו על־ידי המשתמש האלמוני 127.0.0.1.
- api.php?action=query&prop=revisions&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [פתיחה בארגז חול]
- קבלת 5 הגרסאות הראשונות של הדף עמוד ראשי שנעשו על־ידי המשתמש MediaWiki default.
- api.php?action=query&prop=revisions&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [פתיחה בארגז חול]