עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=userrights
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
שינוי חברות בקבוצות של המשתמש.
- user
משתמש.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש וגם מספר מזהה של משתמש (כגון "#12345")
- userid
- מיושן.
יש לציין user=#ID במקום.
- סוג: מספר שלם
- add
הוספת המשתמש לקבוצות האלו, ואם הוא כבר חבר, עדכון זמן התפוגה של החברות בקבוצה הזאת.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): accountcreator, autopatrolled, bot, bureaucrat, checkuser, checkuser-temporary-account-viewer, confirmed, import, interface-admin, ipblock-exempt, no-ipinfo, steward, suppress, sysop, transwiki
- expiry
חותמי־זמן תפוגה. יכולים להיות יחסיים (למשל 5 months או 2 weeks) או מוחלטים (למשל 2014-09-18T12:34:56Z). אם מוגדר רק חותם־זמן אחד, הוא ישמש לכל הקבוצות שהועברו לפרמטר add. יש להשתמש ב־infinite, indefinite, infinity, או never בשביל קבוצת משתמשים שאינה פגה לעולם.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- ברירת המחדל: infinite
- remove
הסרת משתמש מהקבוצות האלו.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): accountcreator, autopatrolled, bot, bureaucrat, checkuser, checkuser-temporary-account-viewer, confirmed, import, interface-admin, ipblock-exempt, no-ipinfo, steward, suppress, sysop, transwiki
- reason
סיבה לשינוי.
- ברירת מחדל: (ריק)
- token
אסימון "userrights" שאוחזר מ־action=query&meta=tokens
לשם תאימות, גם האסימון שמשמש בממשק דפדפן מתקבל.
- הפרמטר הזה נדרש.
לשנות את התגים שיוחלו על הרשומה ביומן הרשאות המשתמש.
- ערכים (מופרדים באמצעות "|" או or תו חלופי):
- watchuser
מעקב אחרי דף המשתמש ודף השיחה של המשתמש הזה
- סוג: בוליאני (פרטים)
- watchlistexpiry
חותם־זמן לתפוגת רשימת המעקב. יש להשמיט את הפרמטר הזה לגמרי כדי להותיר את התפוגה הנוכחית ללא שינוי.
- סוג: תפוגה (פרטים)
- הוספת המשתמש 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 [פתיחה בארגז חול]