עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=usercontribs (uc)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0+
קבלת כל העריכות של המשתמש.
פרמטרים:
- uclimit
המספר המרבי של התרומות להחזיר.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- ucstart
באיזה חותם־הזמן להתחיל.
- סוג: חותם־זמן (תסדירים מורשים)
- ucend
באיזה חותם־הזמן לסיים
- סוג: חותם־זמן (תסדירים מורשים)
- uccontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- ucuser
עבור אילו משתמשים לאחזר תרומות.
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- ucuserprefix
אחזור תרומות עבור כל המשתמשים שהשמות שלהם מתחילים בערך הזה. דורס את ucuser.
- ucdir
באיזה כיוון למנות:
- newer
- לרשום את הישנים ביותר בהתחלה. לתשומת לבך: ucstart חייב להיות לפני ucend.
- older
- לרשום את החדשים ביותר בהתחלה (בררת מחדל). לתשומת לבך: ucstart חייב להיות אחרי ucend.
- אחד מהערכים הבאים: newer, older
- ברירת מחדל: older
- ucnamespace
לרשום רק תרומות במרחבי השם האלה.
- ערכים (מופרדים באמצעות "|"): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- ucprop
לכלול פריטי מידע נוספים:
- ids
- הוספת מזהה הדף ומזהה הגרסה.
- title
- הוספת השם ומזהה מרחב השם של הדף.
- timestamp
- הוספת חותם־הזמן של העריכה.
- comment
- הוספת ההערה על העריכה.
- parsedcomment
- הוספת ההערה המפוענחת של העריכה.
- size
- הוספת הגודל החדש של העריכה.
- sizediff
- הוספת ההפרש של העריכה אל מול ההורה שלה.
- flags
- הוספת הדגלים של העריכה.
- patrolled
- מתייג עריכות בדוקות.
- tags
- רשימת תגים עבור עריכות.
- ערכים (מופרדים באמצעות "|"): ids, title, timestamp, comment, parsedcomment, size, sizediff, flags, patrolled, tags
- ברירת מחדל: ids|title|timestamp|comment|size|flags
- ucshow
הצגה רק של פריטים שמתאימים לאמות המידה האלה, למשל רק עריכות לא־משניות.
אם מוגדר ucshow=patrolled או ucshow=!patrolled, גרסאות ישנות מ־$wgRCMaxAge (7776000 שניות) לא תוצגנה.
- ערכים (מופרדים באמצעות "|"): minor, !minor, patrolled, !patrolled, top, !top, new, !new
- 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.