עזרה של 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 תו חלופי): 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 תו חלופי): 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 [פתיחה בארגז חול]