راهنمای واسط برنامه‌نویسی کاربردی مدیاویکی

این یک صفحهٔ مستندات برای واسط برنامه‌نویسی کاربردی مدیاویکی است که به‌طور خودکار ایجاد شده‌است.

مستندات و نمونه‌ها: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=edit

(main | edit)
  • این پودمان نیازمند اختیارات خواندن است.
  • این پودمان نیازمند اختیارات خواندن است.
  • این پودمان تنها درخواست‌های POST را می‌پذیرد.
  • منبع: MediaWiki
  • مجوز: GPL-2.0-or-later

ایجاد و ویرایش صفحه

پارامترها:
title

عنوان صفحه‌ای که قصد ویرایشش را دارید. نمی‌تواند در کنار pageid استفاده شود.

pageid

شناسه صفحهٔ صفحه‌ای که می‌خواهید ویرایشش کنید. نمی‌تواند در کنار title استفاده شود.

نوع: عدد صحیح
section

شماره بخش. ۰ برای بخش بالا، «تازه» برای یک بخش تازه.

sectiontitle

عنوان برای بخش جدید.

text

محتوای صفحه.

summary

خلاصه را ویرایش کنید. همچنین عنوان بخش را زمانی که section=تازه و sectiontitle تنظیم نشده‌است.

tags

برچسب‌های تغییر برای اعمال بر نسخه.

مقدارهای (جداشده با | یا جایگزین‌های آن):
minor

این ویرایش را به‌عنوان «ویرایش جزئی» نشانه‌گذاری کن.

نوع: بولی (جزئیات)
notminor

ویرایش غیر جزئی.

نوع: بولی (جزئیات)
bot

این ویرایش را به‌عنوان «ویرایش ربات» نشانه‌گذاری کن.

نوع: بولی (جزئیات)
baserevid

ID of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions. Self-conflicts cause the edit to fail unless basetimestamp is set.

نوع: عدد صحیح
basetimestamp

Timestamp of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions&rvprop=timestamp. Self-conflicts are ignored.

نوع: برچسب زمان (قالب‌های مجاز)
starttimestamp

برچسب زمان آغاز فرایند ویرایش، مورد استفاده برای شناسایی تعارض‌های ویرایشی. مقدار مناسب را می‌توان با استفاده از curtimestamp در زمان آغاز فرانید ویرایش (در زمان بارگیری محتوای صفحه به‌منظور ویرایش) به‌دست آورد.

نوع: برچسب زمان (قالب‌های مجاز)
recreate

باطل‌کردن هرگونه خطا پیرامون حذف صفحه در مدت عمل.

نوع: بولی (جزئیات)
createonly

اگر صفحه موجود بود، ویرایش نکن.

نوع: بولی (جزئیات)
nocreate

رها کردن خطا در صورتی که صفحه وجود ندارد.

نوع: بولی (جزئیات)
watch
منسوخ‌شده.

افزودن صفحه به فهرست پیگیری‌‌تان

نوع: بولی (جزئیات)
unwatch
منسوخ‌شده.

حذف صفحه از فهرست پیگیری کاربر کنونی

نوع: بولی (جزئیات)
watchlist

افزودن یا حذف بدون قید و شرط صفحه از فهرست پیگیری‌های کاربر کنونی، پیروی از ترجیحات (برای کاربران ربات نادیده گرفته می‌شود) یا عدم تغییر وضعیت پیگیری.

یکی از مقدارهای زیر: nochange، preferences، unwatch، watch
پیش‌فرض: preferences
md5

هش MD5 پارامتر text، یا پارامترهای prependtext و appendtext به‌هم‌پیوسته. اگر تنظیم شود، ویرایش تا پیش از صحیح بودن هش انجام نخواهد شد.

prependtext

افزودن این متن به ابتدای صفحه یا بخش. text را باطل می‌کند.

appendtext

افزودن این متن به انتهای صفحه یا بخش. text را باطل می‌کند.

برای افزودن یک بخش تازه، به‌جای این پارامتر از section=new استفاده کنید.

undo

خنثی‌سازی این نسخه. text، prependtext و appendtext را باطل می‌کند.

نوع: عدد صحیح
The value must be no less than ۰.
undoafter

بازگردانی تمام نسخه‌ها از undo تا این یکی. اگر تنظیم نشود، فقط یک نسخه بازگردانده می‌شود.

نوع: عدد صحیح
The value must be no less than ۰.
redirect

اصلاح خودکار تغییرمسیرها.

نوع: بولی (جزئیات)
contentformat

قالب تسلسل محتوای مورد استفاده برای متن ورودی.

یکی از مقدارهای زیر: application/json، application/octet-stream، application/unknown، application/x-binary، text/css، text/javascript، text/plain، text/unknown، text/x-wiki، unknown/unknown
contentmodel

مدل محتوا برای محتوای تازه.

یکی از مقدارهای زیر: GadgetDefinition، Scribunto، css، javascript، json، text، unknown، wikitext
token

یک بلیط «csrf» واکشی‌شده از action=query&meta=tokens

بلیط باید همیشه به عنوان آخرین پارامتر، یا دست کم بعد از پارامتر text فرستاده شود.

این پارامتر الزامی است.
captchaword

پاسخ برای کپچا

captchaid

شناسهٔ کپچا از درخواست قبلی