עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
action=protect
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: MediaWiki
- רישיון: GPL-2.0+
לשנות את רמת ההגנה של דף.
- title
כותרת הדף להגנה או הסרת הגנה. לא ניתן להשתמש בזה יחד עם pageid.
- pageid
מזהה הדף להגנה או הסרת הגנה. לא ניתן להשתמש בזה יחד עם title.
- סוג: מספר שלם
- protections
רשימת רמות הכנה, בתסדיר action=level (למשל edit=sysop).
- פרמטר זה נדרש.
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- expiry
חותמי־זמן של תפוגה. אם הוגדר רק חותם־זמן אחד, הוא ישמש לכל ההגנות. יש להשתמש ב־infinite, indefinite, infinity, או never להגנה שלא פגה לעולם.
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- ברירת מחדל: infinite
- reason
סיבה להגנה או הסרת הגנה.
- ברירת מחדל: (ריק)
- cascade
הפעלת הגנה מדורגת (כלומר, להגן על דפים שמוכללים בדף הזה ועל תמונות שמשמות בו). אין לזה השפעה אם אף אחת מרמות ההגנה שניתנו אינה תומכת בדירוג.
- סוג: בוליאני (פרטים)
- watch
- מיושן.
אם זה מוגדר, הוספת הדף שהגנה נוספת אליו או מוסרת ממנו לרשימת המעקב של המשתמש הנוכחי.
- סוג: בוליאני (פרטים)
- watchlist
הוספה או הסרה של הדף ללא תנאי מרשימת המעקב של המשתמש הנוכחי, להשתמש בהעדפות או לא לשנות את המעקב.
- אחד מהערכים הבאים: watch, unwatch, preferences, nochange
- ברירת מחדל: preferences
- token
אסימון "csrf" שאוחזר מ־action=query&meta=tokens
- פרמטר זה נדרש.
- הגנה על דף.
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=sysop|move=sysop&cascade=&expiry=20070901163000|never
- להסיר את ההגנה מהדף על־ידי הגדרת מגבלות על all.
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=all|move=all&reason=Lifting%20restrictions
- הסרת הגנה מדף על־ידי הגדרה של אפס הגבלות.
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=&reason=Lifting%20restrictions