עזרה של MediaWiki API

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

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

action=globalblock

(main | globalblock)

יחידה זו דורשת הרשאות קריאה.
היחידה הזאת דורשת הרשאות כתיבה.
יחידה זו מקבלת רק בקשות POST.
מקור: GlobalBlocking
רישיון: GPL-2.0-or-later

חסימה גלובלית או שחרור חסימה גלובלית של משתמש.

פרמטרים ייעודיים:

זמינים פרמטרים כלליים אחרים.

id: מזהה החסימה הגלובלית לשינוי או שחרור (מתקבל דרך list=globalblocks). לא יכול לשמש יחד עם target.; סוג: מספר שלם
target: כתובת ה־IP או שם המשתמש של היעד. לא יכול לשמש יחד עם id.; סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף וגם טווח כתובות IP
expiry: אם זה מצוין, זה יחסום או יבטל את החסימה של המשתמש. זה מגדיר למשך כמה זמן החסימה תימשך, למשל "5 months" או "2 weeks". אם מוגדר "infinite" או "indefinite", החסימה לעולם לא תפוג.; סוג: תפוגה (פרטים)
unblock: אם זה מצוין, המשתמש ישוחרר.; סוג: בוליאני (פרטים)
reason: הסיבה לחסימה או לשחרור.; הפרמטר הזה נדרש.
anononly: יש לציין את זה אם החסימה צריכה להשפיע גלובלית רק על משתמשים שלא נכנסו לחשבון.; סוג: בוליאני (פרטים)
allow-account-creation: יש להגדיר את זה אם החסימה הגלובלית לא צריכה למנוע יצירת חשבון.; סוג: בוליאני (פרטים)
enable-autoblock: יש לציין את זה אם החסימה הגלובלית צריכה להפעיל חסימות אוטומטיות גלובליות.; סוג: בוליאני (פרטים)
modify: יש להגדיר את זה אם חסימה קיימת ביעד צריכה להשתנות; סוג: בוליאני (פרטים)
alsolocal: לחסום את המשתמש גם מקומית. לא יכול לשמש יחד עם id.; סוג: בוליאני (פרטים)
localblockstalk: לשלול מקומית גישה לדפי שיחה. לא יכול לשמש יחד עם id.; סוג: בוליאני (פרטים)
localblocksemail: לשלול מקומית גישה לדואר אלקטרוני. לא יכול לשמש יחד עם id.; סוג: בוליאני (פרטים)
localanononly: יש לציין את זה אם החסימה צריכה להשפיע על משתמשים שלא נכנסו לחשבון רק מקומית. לא יכול לשמש יחד עם id.; סוג: בוליאני (פרטים)
local-allow-account-creation: יש לציין את זה אם החסימה המקומית לא צריכה למנוע יצירת חשבון. לא יכול לשמש יחד עם id.; סוג: בוליאני (פרטים)
token: אסימון "csrf" שאוחזר מ־action=query&meta=tokens; הפרמטר הזה נדרש.

דוגמה:

לחסום את 192.0.2.1 לצמיתות עם הסיבה "Cross-wiki abuse": api.php?action=globalblock&target=192.0.2.1&expiry=indefinite&reason=Cross-wiki%20abuse&token=123ABC [פתיחה בארגז חול]