עזרה של 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, 108, 109, 118, 119, 710, 711, 828, 829, 2600
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- ucprop
לכלול פריטי מידע נוספים:
- ids
- הוספת מזהה הדף ומזהה הגרסה.
- title
- הוספת השם ומזהה מרחב השם של הדף.
- timestamp
- הוספת חותם־הזמן של העריכה.
- comment
- הוספת ההערה על העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- parsedcomment
- הוספת ההערה המפוענחת של העריכה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- size
- הוספת הגודל החדש של העריכה.
- sizediff
- הוספת ההפרש של העריכה אל מול ההורה שלה.
- flags
- הוספת הדגלים של העריכה.
- patrolled
- מתייג עריכות בדוקות.
- tags
- רשימת תגים עבור עריכות.
- oresscores
- הוספת דירוגי ORES לעריכה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, flags, ids, oresscores, parsedcomment, patrolled, size, sizediff, tags, timestamp, title
- ברירת המחדל: ids|title|timestamp|comment|size|flags
- ucshow
הצגה רק של פריטים שמתאימים לאמות המידה האלו, למשל רק עריכות לא־משניות.
אם מוגדר ucshow=patrolled או ucshow=!patrolled, גרסאות ישנות מ־$wgRCMaxAge (2592000 שניות) לא תוצגנה.
בעת שימוש ב־oresreview או !oresreview, גרסאות ללא דירוג (למשל גרסאות ישנות מאוד) נחשבות בתור כאלה שאינן זקוקות לסקירה אף אם הן היו צריכות סקירה אילו קיבלו דירוג.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): !autopatrolled, !minor, !new, !oresreview, !patrolled, !top, autopatrolled, minor, new, oresreview, 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. [פתיחה בארגז חול]