עזרה של 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). רמת all פירושה שכולם מורשים לבצע את הפעולה, כלומר אין הגנה.
הערה: ההגבלות יוסרו מכל הפעולות שלא כתובות ברשימה.
- פרמטר זה נדרש.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- expiry
חותמי־זמן של תפוגה. אם הוגדר רק חותם־זמן אחד, הוא ישמש לכל ההגנות. יש להשתמש ב־infinite, indefinite, infinity, או never להגנה שלא פגה לעולם.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- ברירת מחדל: infinite
- reason
סיבה להגנה או הסרת הגנה.
- ברירת מחדל: (ריק)
- tags
תגי שינוי שיחולו על העיול ביומן ההגנה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי):
- 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 [פתיחה בארגז חול]