עזרה של MediaWiki API

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

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

list=blocks (bk)

(main | query | blocks)
  • יחידה זו דורשת הרשאות קריאה.
  • מקור: MediaWiki
  • רישיון: GPL-2.0+

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

פרמטרים:
bkstart

מאיזה חותם‏־זמן להתחיל למנות.

סוג: חותם־זמן (תסדירים מורשים)
bkend

באיזה חותם זמן להפסיק למנות.

סוג: חותם־זמן (תסדירים מורשים)
bkdir

באיזה כיוון למנות:

newer
לרשום את הישנים ביותר בהתחלה. לתשומת לבך: bkstart חייב להיות לפני bkend.
older
לרשום את החדשים ביותר בהתחלה (בררת מחדל). לתשומת לבך: bkstart חייב להיות אחרי bkend.
אחד מהערכים הבאים: newer, older
ברירת מחדל: older
bkids

רשימת מזהי חסימות לרשום (לא חובה).

סוג: רשימת מספרים שלמים
הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
bkusers

רשימת משתמשים לחיפוש (לא חובה).

סוג: רשימת שמות משתמשים
הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
bkip

קבלת כל החסימות שחלות על טווח ה־IP או ה־CIDR הזה, כולל חסימות טווח. לא יכול לשמש יחד עם bkusers. טווחי CIDR רחבים מ־IPv4/16 או IPv6/19 אינם מתקבלים.

bklimit

המספר המרבי של חסימות לרשום.

המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
סוג: מספר שלם או max
ברירת מחדל: 10
bkprop

אילו מאפיינים לקבל:

id
הוספת מזהה החסימה.
user
הוספת שם המשתמש שנחסם.
userid
הוספת המזהה של המשמש שנחסם.
by
הוספת שם המשתמש שחסם.
byid
הוספת מזהה המשתמש שחסם.
timestamp
הוספת חותם־הזמן של החסימה.
expiry
הוספת חותם־הזמן של תפוגת החסימה.
reason
הוספת הסיבה שניתנה לחסימה.
range
הוספת טווח כתובות ה־IP שהחסימה משפיעה עליהן.
flags
מתייג את ההחרמה (autoblock‏, anononly, וכו'.).
ערכים (מופרדים באמצעות "|" או or תו חלופי): id, user, userid, by, byid, timestamp, expiry, reason, range, flags
ברירת מחדל: id|user|by|timestamp|expiry|reason|flags
bkshow

להציג רק פריטים שמתאימים לאמות המידה האלו. למשל, כדי לראות רק חסימות ללא לצמיתות על כתובות IP יש להגדיר bkshow=ip|!temp.

ערכים (מופרדים באמצעות "|" או or תו חלופי): account, !account, temp, !temp, ip, !ip, range, !range
bkcontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.

דוגמאות:
רשימת חסימות.
api.php?action=query&list=blocks [פתיחה בארגז חול]
רשימת חסימות של המשתמשים Alice ו־Bob.
api.php?action=query&list=blocks&bkusers=Alice|Bob [פתיחה בארגז חול]