עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=watchlist (wl)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת שינויים אחרונים לדפים ברשימת המעקב של המשתמש הנוכחי.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- wlallrev
לכלול גרסאות מרובות של אותו הדף בתוך מסגרת הזמן הנתונה.
- סוג: בוליאני (פרטים)
- wlstart
מאיזה חותם־זמן להתחיל למנות.
- סוג: חותם־זמן (תסדירים מורשים)
- wlend
באיזה חותם־זמן להפסיק למנות.
- סוג: חותם־זמן (תסדירים מורשים)
- wlnamespace
סינון שינויים רק למרחבי השם שניתנו.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 108, 109, 110, 111, 710, 711, 828, 829
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- wluser
לרשום רק שינויים של המשתמש הזה.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- wlexcludeuser
לא לרשום שינויים של המשתמש הזה.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
- wldir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת ליבך: wlstart חייב להיות לפני wlend.
- older
- לרשום את החדשים ביותר בהתחלה (ברירת מחדל). לתשומת ליבך: wlstart חייב להיות אחרי wlend.
- אחד מהערכים הבאים: newer, older
- ברירת המחדל: older
- wllimit
כמה תוצאות סך הכול להחזיר בכל בקשה.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 10
- wlprop
אילו מאפיינים נוספים לקבל:
- ids
- הוספת מזהי גסה ומזהי דף.
- title
- הוספת שם הדף.
- flags
- הוספת דגלים לעריכה.
- user
- הוספת המשתמש שעשה את העריכה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- userid
- הוספת מזהה המשתמש של מי שעשה את העריכה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- comment
- הוספת ההערה של העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- parsedcomment
- הוספת ההערכה המפוענחת של העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- timestamp
- הוספת חותם־זמן של העריכה.
- patrol
- תיוג עריכות שנבדקו.
- sizes
- הוספת האורך החדש והישן של הדף.
- notificationtimestamp
- הוספת חותם־זמן של ההודעה האחרונה למשתמש על העריכה.
- loginfo
- הוספת מידע מהיומן איפה שמתאים.
- tags
- רשימת תגיות עבור הפעולה.
- expiry
- הוספת זמן התפוגה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, expiry, flags, ids, loginfo, notificationtimestamp, parsedcomment, patrol, sizes, tags, timestamp, title, user, userid
- ברירת המחדל: ids|title|flags
- wlshow
הצגה רק של פריטים שמתאימים לאמות המידה האלו. למשל, כדי לראות רק עריכות משניות שעשו משתמשים שנכנסו לחשבון, יש להגדיר wlshow=minor|!anon.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): !anon, !autopatrolled, !bot, !minor, !patrolled, !unread, anon, autopatrolled, bot, minor, patrolled, unread
- wltype
אולי סוגי שינויים להציג:
- edit
- עריכות דף רגילות.
- new
- יצירות דף.
- log
- רשומות יומן.
- external
- שינויים חיצוניים.
- categorize
- שינויים בהשתייכות לקטגוריה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): categorize, edit, external, log, new
- ברירת המחדל: edit|new|log|categorize
- wlowner
משמש יחד עם wltoken לגישה לרשימת מעקב של משתמש אחר.
- סוג: משתמש, בצורה הבאה: שם משתמש
- wltoken
אסימון אבטחה (זמין ב־העדפות) שמאפשר לגשת לרשימת מעקב של משתמש אחר.
- wlcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
דוגמאות:
- לרשום את הגרסה האחרונה עבור דפים שהשתנו לאחרונה ברשימת המעקב של המשתמש הנוכחי.
- api.php?action=query&list=watchlist [פתיחה בארגז חול]
- אחזור מידע נוסף על הגרסה האחרונה עבור דפים שהשתנו לאחרונה ברשימת המעקב של המשתמש הנוכחי.
- api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment [פתיחה בארגז חול]
- אחזור מידע נוסף על הגרסה החדשה ביותר של הדפים שהשתנו לאחרונה שברשימת המעקב של המשתמש, כולל מתי פריטים בתצוגה זמנית יפוגו.
- api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment|expiry [פתיחה בארגז חול]
- אחזור מידע על כל השינויים האחרונים לדפים ברשימת המעקב של המשתמש הנוכחי.
- api.php?action=query&list=watchlist&wlallrev=&wlprop=ids|title|timestamp|user|comment [פתיחה בארגז חול]
- אחזור מידע על הדף עבור דפים שהשתנו לאחרונה ברשימת המעקב של המשתמש הנוכחי.
- api.php?action=query&generator=watchlist&prop=info [פתיחה בארגז חול]
- אחזור מידע על הגרסה עבור דפים שהשתנו לאחרונה ברשימת המעקב של המשתמש הנוכחי.
- api.php?action=query&generator=watchlist&gwlallrev=&prop=revisions&rvprop=timestamp|user [פתיחה בארגז חול]
- לרשום את הגרסה האחרונה עבור דפים שהשתנו לאחרונה ברשימת המעקב של משתמש Example.
- api.php?action=query&list=watchlist&wlowner=Example&wltoken=123ABC [פתיחה בארגז חול]