עזרה של MediaWiki API

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

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

action=userrights

(main | userrights)
  • יחידה זו דורשת הרשאות קריאה.
  • היחידה הזאת דורשת הרשאות כתיבה.
  • יחידה זו מקבלת רק בקשות POST.
  • מקור: MediaWiki
  • רישיון: GPL-2.0+

שינוי חברות בקבוצות של המשתמש.

פרמטרים:
user

שם משתמש.

סוג: שם משתמש
userid

מזהה משתמש.

סוג: מספר שלם
add

הוספת המשתמש לקבוצות האלו, ואם הוא כבר חבר, עדכון זמן התפוגה של החברות בקבוצה הזאת.

ערכים (מופרדים באמצעות "|" או or תו חלופי): bot, sysop, bureaucrat
expiry

חותמי־זמן תפוגה. יכולים להיות יחסיים (למשל 5 months או 2 weeks) או מוחלטים (למשל 2014-09-18T12:34:56Z). אם מוגדר רק חותם־זמן אחד, הוא ישמש לכל הקבוצות שהועברו לפרמטר add. יש להשתמש ב־infinite‏, indefinite‏, infinity, או never בשביל קבוצת משתמשים שאינה פגה לעולם.

הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
ברירת מחדל: infinite
remove

הסרת משתמש מהקבוצות האלו.

ערכים (מופרדים באמצעות "|" או or תו חלופי): bot, sysop, bureaucrat
reason

סיבה לשינוי.

ברירת מחדל: (ריק)
token

אסימון "userrights" שאוחזר מ־action=query&meta=tokens

לשם תאימות, גם האסימון שמשמש בממשק דפדפן מתקבל.

פרמטר זה נדרש.
tags

לשנות את התגים שיוחלו על העיול ביומן הרשאות המשתמש.

ערכים (מופרדים באמצעות "|" או or תו חלופי):
דוגמאות:
הוספת המשתמש FooBot לקבוצה bot והסרתו מהקבוצות sysop ו־bureaucrat.
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [פתיחה בארגז חול]
הוספת המשתמש עם המזהה 123 לקבוצה bot והסרתו מהקבוצות sysop ו־bureaucrat.
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC [פתיחה בארגז חול]
להוסיף את SometimeSysop לקבוצה sysop לחודש אחד.
api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [פתיחה בארגז חול]