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