עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

list=usercontribs (uc)

(main | query | usercontribs)
  • יחידה זו דורשת הרשאות קריאה.
  • מקור: 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
כדי לתת את כל הערכים, יש להשתמש ב־*.
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. [פתיחה בארגז חול]