עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=globalblocks (bg)
- יחידה זו דורשת הרשאות קריאה.
- מקור: GlobalBlocking
- רישיון: GPL-2.0-or-later
רשימה של כתובות ה־IP שחסומות גלובלית.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- bgstart
חותם־הזמן שהמנייה תתחיל ממנו.
- סוג: חותם־זמן (תסדירים מורשים)
- bgend
חותם־הזמן שהמנייה תסתיים בו.
- סוג: חותם־זמן (תסדירים מורשים)
- bgdir
באיזה כיוון למנות:
- אחד מהערכים הבאים: newer, older
- ברירת המחדל: older
- bgids
רשימה מופרדת בקווים ניצבים של מזהי חסימה לרשום.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- bgaddresses
- מיושן.
רשימה מופרדת בקווים ניצבים של כתובות IP לחפש.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- bgtargets
רשימה מופרדת בקווים ניצבים (|) של שמות משתמש, כתובות IP או טווחי IP לחיפוש. כדי לחפש חסימות IP בטווח נתון, יש להשתמש במקום זאת ב־bgip.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- bgip
קבלת כל החסימות שחלות על כתובת ה־IP הזאת או על טווח ה־CIDR הזה, כולל חסימות טווח. לא ניתן להשתמש בזה יחד עם bgaddresses או bgtargets. טווחי CIDR רחבים יותר מ־/16 אינם מתקבלים.
- bglimit
המספר המרבי של חסימות ברשימה.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 10
- bgprop
אילו מאפיינים להחזיר.
- id
- הוספת מזהה החסימה הגלובלית.
- address
- מיושן. הוספת יעד החסימה הגלובלית. זה הוכרז בתור מיושן והוחלף על־ידי מאפיין target.
- target
- הוספת יעד החסימה הגלובלית.
- by
- הוספת שם המשתמש של המשתמש החוסם, יחד עם הוויקי שבו הוא עשה את החסימה הגלובלית.
- timestamp
- הוספת חותם־הזמן של החסימה הגלובלית.
- expiry
- הוספת חותם־הזמן של תפוגת החסימה הגלובלית.
- reason
- הוספת הסיבה שניתנה לחסימה הגלובלית.
- range
- הוספת טווח כתובות ה־IP המושפעות מהחסימה הגלובלית (לא כלול אם החסימה אינה מכוונת לכתובות IP).
- ערכים (מופרדים באמצעות "|" או or תו חלופי): by, expiry, id, range, reason, target, timestamp, address
- ברירת המחדל: id|target|by|timestamp|expiry|reason
דוגמאות:
- רשימת כל החסימות הגלובליות
- api.php?action=query&list=globalblocks [פתיחה בארגז חול]
- רשימת חסימות גלובלית של כתובת IP של 192.0.2.18
- api.php?action=query&list=globalblocks&bgip=192.0.2.18 [פתיחה בארגז חול]