עזרה של MediaWiki API

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

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

action=block

(main | block)
  • יחידה זו דורשת הרשאות קריאה.
  • היחידה הזאת דורשת הרשאות כתיבה.
  • יחידה זו מקבלת רק בקשות POST.
  • מקור: MediaWiki
  • רישיון: GPL-2.0+

חסימת משתמש.

פרמטרים:
user

שם משתמש, כתובת IP, או טווח כתובות IP שברצונך לחסום. אי־אפשר להשתמש בזה יחד עם userid

סוג: שם משתמש
userid

מזהה המשתמש לחסימה. לא יכול לשמש יחד עם user.

סוג: מספר שלם
expiry

זמן תפוגה. יכול להיות יחסי (למשל 5 months או 2 weeks) או מוחלט (למשל 2014-09-18T12:34:56Z). אם זה מוגדר ל־infinite‏, indefinite, או never, החסימה לא תפוג לעולם.

ברירת מחדל: never
reason

סיבה לחסימה.

ברירת מחדל: (ריק)
anononly

לחסום משתמשים אלמוניים בלבד (דהיינו, השבתת עריכות אלמוניות מכתובת ה־IP הזאת)

סוג: בוליאני (פרטים)
nocreate

מניעת יצירת חשבונות

סוג: בוליאני (פרטים)
autoblock

חסימה אוטומטית גם של כתובת ה־IP האחרונה שהשתמש בה ושל כל כתובת IP שינסה להשתמש בה בעתיד.

סוג: בוליאני (פרטים)
noemail

למנוע ממשתמש לשלוח דואר אלקטרוני דרך הוויקי. (דורש את ההרשאה blockemail).

סוג: בוליאני (פרטים)
hidename

הסרת השם מיומן החסימות. (דורש את ההרשאה hideuser.)

סוג: בוליאני (פרטים)
allowusertalk

לאפשר למשתמש לערוך את דף השיחה שלו או שלה (תלוי ב־$wgBlockAllowsUTEdit).

סוג: בוליאני (פרטים)
reblock

אם המשתמש כבר חסום, לדרוס את החסימה הנוכחית.

סוג: בוליאני (פרטים)
watchuser

לעקוב אחרי דף המשתמש ודף השיחה של המשתמש או של כתובת ה־IP.

סוג: בוליאני (פרטים)
tags

תגי שינוי שיחולו על העיול ביומן החסימה.

ערכים (מופרדים באמצעות "|" או or תו חלופי):
token

אסימון "csrf" שאוחזר מ־action=query&meta=tokens

פרמטר זה נדרש.
דוגמאות:
חסימת כתובת ה־IP‏ 192.0.2.5 לשלושה ימים עם הסיבה First strike.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [פתיחה בארגז חול]
חסימת המשתמש Vandal ללא הגבלת זמן עם הסיבה Vandalism, ומניעת יצירת חשבונות חדשים ושליחת דוא"ל.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [פתיחה בארגז חול]