עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=usercontribs (uc)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת כל העריכות של המשתמש.
- uclimit
המספר המרבי של התרומות להחזיר.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 10
- ucstart
באיזה חותם־הזמן להתחיל, כלומר גרסאות לפני חותם־הזמן הזה.
- סוג: חותם־זמן (תסדירים מורשים)
- ucend
באיזה חותם־הזמן לסיים, כלומר גרסאות אחרי חותם־הזמן הזה.
- סוג: חותם־זמן (תסדירים מורשים)
- uccontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
- ucuser
עבור אילו משתמשים לאחזר תרומות. לא יכול לשמש עם ucuserids, ucuserprefix או uciprange.
- סוג: רשימת משתמשים, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP וגם שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName")
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- ucuserids
מזהי המשתמשים לאחזור תרומות. לא יכול לשמש עם ucuser, ucuserprefix או uciprange.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- ucuserprefix
אחזור תרומות עבור כל המשתמשים שהשמות שלהם מתחילים בערך הזה. לא יכול לשמש עם ucuser, ucuserids או uciprange.
- uciprange
טווח CIDR המשתמשים לאחזור תרומות. לא יכול לשמש עם ucuser, ucuserprefix או ucuserids.
- ucdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת ליבך: ucstart חייב להיות לפני ucend.
- older
- לרשום את החדשים ביותר בהתחלה (ברירת מחדל). לתשומת ליבך: ucstart חייב להיות אחרי ucend.
- אחד מהערכים הבאים: newer, older
- ברירת המחדל: older
- ucnamespace
לרשום רק תרומות במרחבי השם האלה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 100, 101, 710, 711, 828, 829, 2300, 2301, 2302, 2303
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- ucprop
לכלול פריטי מידע נוספים:
- ids
- הוספת מזהה הדף ומזהה הגרסה.
- title
- הוספת השם ומזהה מרחב השם של הדף.
- timestamp
- הוספת חותם־הזמן של העריכה.
- comment
- הוספת ההערה על העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- parsedcomment
- הוספת ההערה המפוענחת של העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- size
- הוספת הגודל החדש של העריכה.
- sizediff
- הוספת ההפרש של העריכה אל מול ההורה שלה.
- flags
- הוספת הדגלים של העריכה.
- patrolled
- מתייג עריכות בדוקות.
- tags
- רשימת תגים עבור עריכות.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, flags, ids, parsedcomment, patrolled, size, sizediff, tags, timestamp, title
- ברירת המחדל: ids|title|timestamp|comment|size|flags
- ucshow
הצגה רק של פריטים שמתאימים לאמות המידה האלו, למשל רק עריכות לא־משניות.
אם מוגדר ucshow=patrolled או ucshow=!patrolled, גרסאות ישנות מ־$wgRCMaxAge (7776000 שניות) לא תוצגנה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): !autopatrolled, !minor, !new, !patrolled, !top, autopatrolled, minor, new, patrolled, top
- uctag
לרשום רק גרסאות עם התג הזה.
- uctoponly
- מיושן.
לרשום רק שינויים שהם הגרסה האחרונה.
- סוג: בוליאני (פרטים)
- הצגת התרומות של המשתמש Example.
- api.php?action=query&list=usercontribs&ucuser=Example [פתיחה בארגז חול]
- הצגת תרומות מכל כתובות ה־IP שמתחילות ב־192.0.2..
- api.php?action=query&list=usercontribs&ucuserprefix=192.0.2. [פתיחה בארגז חול]