עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=protect
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
לשנות את רמת ההגנה של דף.
- title
כותרת הדף להגנה או הסרת הגנה. לא ניתן להשתמש בזה יחד עם pageid.
- pageid
מזהה הדף להגנה או הסרת הגנה. לא ניתן להשתמש בזה יחד עם title.
- סוג: מספר שלם
- protections
רשימת רמות הגנה, בתסדיר action=level (למשל edit=sysop). רמת all פירושה שכולם מורשים לבצע את הפעולה, כלומר אין הגנה.
הערה: ההגבלות יוסרו מכל הפעולות שלא כתובות ברשימה.
- הפרמטר הזה נדרש.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- expiry
חותמי־זמן של תפוגה. אם הוגדר רק חותם־זמן אחד, הוא ישמש לכל ההגנות. יש להשתמש ב־infinite, indefinite, infinity, או never להגנה שלא פגה לעולם.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- ברירת המחדל: infinite
- reason
סיבה להגנה או הסרת הגנה.
- ברירת מחדל: (ריק)
תגי שינוי שיחולו על הרשומה ביומן ההגנה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי):
- cascade
הפעלת הגנה מדורגת (כלומר, להגן על דפים שמוכללים בדף הזה ועל תמונות שמשמות בו). אין לזה השפעה אם אף אחת מרמות ההגנה שניתנו אינה תומכת בדירוג.
- סוג: בוליאני (פרטים)
- watch
- מיושן.
אם זה מוגדר, הוספת הדף שהגנה נוספת אליו או מוסרת ממנו לרשימת המעקב של המשתמש הנוכחי.
- סוג: בוליאני (פרטים)
- watchlist
הוספה או הסרה של הדף ללא תנאי מרשימת המעקב של המשתמש הנוכחי, להשתמש בהעדפות (לא חל על משתמשי בוט), או לא לשנות את המעקב.
- אחד מהערכים הבאים: nochange, preferences, unwatch, watch
- ברירת המחדל: preferences
- watchlistexpiry
חותם־זמן לתפוגת רשימת המעקב. יש להשמיט את הפרמטר הזה לגמרי כדי להותיר את התפוגה הנוכחית ללא שינוי.
- סוג: תפוגה (פרטים)
- token
אסימון "csrf" שאוחזר מ־action=query&meta=tokens
- הפרמטר הזה נדרש.
- הגנה על דף.
- api.php?action=protect&title=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&token=123ABC&protections=edit=sysop|move=sysop&cascade=&expiry=20070901163000|never [פתיחה בארגז חול]
- להסיר את ההגנה מהדף על־ידי הגדרת מגבלות על all (למשל: כולם מורשים לבצע את הפעולה).
- api.php?action=protect&title=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&token=123ABC&protections=edit=all|move=all&reason=Lifting%20restrictions [פתיחה בארגז חול]
- הסרת הגנה מדף על־ידי הגדרה של אפס הגבלות.
- api.php?action=protect&title=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&token=123ABC&protections=&reason=Lifting%20restrictions [פתיחה בארגז חול]