עזרה של MediaWiki API

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

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

action=userrights

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

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

פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
user

משתמש.

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש וגם מספר מזהה של משתמש (כגון "#12345")
userid
מיושן.

יש לציין user=#ID במקום.

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

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

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

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

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

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

ערכים (מופרדים באמצעות "|" או or תו חלופי): admin, bot, bureaucrat, interface-admin, suppress, sysop
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 [פתיחה בארגז חול]