راهنمای واسط برنامه‌نویسی کاربردی مدیاویکی
این یک صفحهٔ مستندات برای واسط برنامه‌نویسی کاربردی مدیاویکی است که به‌طور خودکار ایجاد شده‌است.
مستندات و نمونه‌ها: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=protect
- این پودمان نیازمند اختیارات خواندن است.
- این پودمان نیازمند اختیارات خواندن است.
- این پودمان تنها درخواست‌های POST را می‌پذیرد.
- منبع: MediaWiki
- مجوز: GPL-2.0-or-later
تغییر سطح محافظت صفحه
- title
عنوان صفحه برای محافظت/خروج از محافظت. نمی‌تواند همزمان با pageid استفاده شود.
- pageid
شناسهٔ صفحه برای محافظت/خروج از محافظت. نمی‌تواند همزمان با title استفاده شود.
- نوع: عدد صحیح
- protections
فهرست سطوح محافظت، قالب‌بندی‌شده به‌شکل عمل=سطح (مثلاً edit=sysop). سطح all به این معنی است که همه می‌توانند آن عمل را انجام دهند و به عبارت دیگر، برابر با عدم محافظت است.
نکته: هر عمل فهرست‌نشده‌ای مشمول حذف محدودیت‌ها خواهد شد.
- این پارامتر الزامی است.
- Separate values with | or alternative.
- حداکثر تعداد مقدارها ۵۰ است (۵۰۰ برای متقضایانی که مجوز محدودیت‌های بالاتر را دارند).
- expiry
برچسب‌های زمان منقضی‌شدن. اگر تنها یک برچسب زمان وارد شود، برای تمامی محافظت‌ها مورد استفاده قرار خواهد گرفت. برای زمان منقضی‌شدن نامعین از infinite، indefinite، infinity، یا never استفاده کنید.
- Separate values with | or alternative.
- حداکثر تعداد مقدارها ۵۰ است (۵۰۰ برای متقضایانی که مجوز محدودیت‌های بالاتر را دارند).
- پیش‌فرض: infinite
- reason
دلیل برای محافظت/خروج از محافظت.
- پیش‌فرض: (خالی)
- tags
برچسب‌های تغییر برای افزودن به مدخل سیاههٔ محافظت.
- مقدارهای (جداشده با | یا جایگزین‌های آن):
- cascade
فعال‌سازی محافظت آبشاری (محافظت الگوهای تراگنجانده‌شده و تصاویر استفاده‌شده در صفحه). اگر هیچ‌یک از سطوح محافظت واردشده از محافظت آبشاری پشتیبانی نکنند، از این پارامتر چشم‌پوشی خواهد شد.
- نوع: بولی (جزئیات)
- watch
- منسوخ‌شده.
اگر تنظیم شود، صفحهٔ هدف محافظت/خروج از محافظت به فهرست پیگیری کاربر کنونی افزوده خواهد شد.
- نوع: بولی (جزئیات)
- watchlist
افزودن یا حذف بدون قید و شرط صفحه از فهرست پیگیری‌های کاربر کنونی، پیروی از ترجیحات (برای کاربران ربات نادیده گرفته می‌شود) یا عدم تغییر وضعیت پیگیری.
- یکی از مقدارهای زیر: nochange، preferences، unwatch، watch
- پیش‌فرض: 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 [باز کردن در صفحهٔ تمرین]