עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=blocks (bk)
- יחידה זו דורשת הרשאות קריאה.
- מקור: 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 [פתיחה בארגז חול]