עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=globaluserrights
(main | globaluserrights)
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: CentralAuth
- רישיון: GPL-2.0-or-later
הוספה/הסרה של משתמש אל/מתוך קבוצות גלובליות.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- user
שם משתמש גלובלי.
- סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש וגם מספר מזהה של משתמש (כגון "#12345")
- userid
- מיושן.
מזהה משתמש גלובלי.
- סוג: מספר שלם
- add
הספת משתמש לקבוצות הגלובליות האלו.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): abusefilter-helper, abusefilter-maintainer, apihighlimits-requestor, captcha-exempt, founder, global-bot, global-deleter, global-flow-create, global-interface-editor, global-ipblock-exempt, global-rollbacker, global-sysop, new-wikis-importer, oathauth-tester, ombuds, recursive-export, staff, steward, sysadmin, vrt-permissions, wmf-email-block-override, wmf-researcher
- expiry
חותמי־זמן תפוגה. יכולים להיות יחסיים (למשל 5 months או 2 weeks) או מוחלטים (למשל 2014-09-18T12:34:56Z). אם מוגדר רק חותם־זמן אחד, הוא ישמש לכל הקבוצות שהועברו לפרמטר add. יש להשתמש ב־infinite, indefinite, infinity, או never בשביל קבוצת משתמשים שאינה פגה לעולם.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- ברירת המחדל: infinite
- remove
הסרת משתמש מהקבוצות הגלובליות האלו.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): abusefilter-helper, abusefilter-maintainer, apihighlimits-requestor, captcha-exempt, founder, global-bot, global-deleter, global-flow-create, global-interface-editor, global-ipblock-exempt, global-rollbacker, global-sysop, new-wikis-importer, oathauth-tester, ombuds, recursive-export, staff, steward, sysadmin, vrt-permissions, wmf-email-block-override, wmf-researcher
- reason
סיבה לשינוי
- ברירת מחדל: (ריק)
- token
אסימון "userrights" שאוחזר מ־action=query&meta=tokens
לשם תאימות, גם האסימון שמשמש בממשק דפדפן מתקבל.
- הפרמטר הזה נדרש.
הפרמטר הזה לא נמצא בשימוש כעת.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 1lib1ref, AWB, Cat-a-lot, HotCat, VandalCleaner, contenttranslation-needcheck, quick linker, בדיקת-עריכה, בקשות_ממפעילים, דיונים נוחים, לבדיקה נוספת, מילים_בעייתיות, ניטור_תמונות, עריכה_בתשלום, צ'קטי, תו כיווניות מפורש, תקלדה-בקליק
דוגמאות:
- הוספת המשתמש 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 [פתיחה בארגז חול]