مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- هذه الوحدة تتطلب صلاحيات القراءة.
- هذه الوحدة تتطلب صلاحيات الكتابة.
- هذه الوحدة تقبل طلبات POST فقط.
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
إنشاء وتعديل الصفحات.
- title
عنوان الصفحة للحذف. لا يمكن أن يُستخدَم جنبا إلى جنب مع pageid</var
- pageid
معرف الصفحة لتحريرها. لا يمكن أن يُستخدَم جنبا إلى جنب مع pageid</var
- النوع: 2 = قائمة الأعداد الصحيحة
- section
معرف القسم. 0 للقسم العلوي ، جديد لقسم جديد. غالبًا ما يكون عددًا صحيحًا موجبًا ، ولكن يمكن أن يكون أيضًا غير رقمي.
- sectiontitle
عنوان القسم الجديد عند استخدام قسم = جديد .
- text
محتوى الصفحة
- summary
تحرير الملخص.
عندما لا يتم توفير هذه المعلمة أو فارغة ، يمكن إنشاء ملخص تحرير تلقائيًا.
عند استخدام section=new و sectiontitle غير متوفر ، ويتم استخدام قيمة هذه المعلمة لعنوان القسم بدلاً من ذلك ، ويتم إنشاء ملخص التحرير تلقائيًا.
عدل الوسوم لتطبيق المراجعة.
- القيم (منفصلة مع | أو البديل):
- minor
التعليم على هذا التعديل كتعديل طفيف.
- النوع: منطقي (التفاصيل)
- notminor
عدم التعليم على هذا التعديل كتعديل طفيف حتى إذا تم تعيين تفضيل المستخدم "علّم جميع التعديلات على أنها طفيفة بشكلٍ افتراضي".
- النوع: منطقي (التفاصيل)
- bot
علم على هذا التعديل كتعديل بوت.
- النوع: منطقي (التفاصيل)
- baserevid
معرّف المراجعة الأساسية ، يُستخدم للكشف عن تعارضات التحرير. يمكن الحصول عليها من خلال action=query&prop=revisions. تتسبب التعارضات الذاتية في فشل التحرير ما لم يتم تعيين basetimestamp.
- النوع: 2 = قائمة الأعداد الصحيحة
- basetimestamp
الطابع الزمني للمراجعة الأساسية ، يستخدم لاكتشاف تعارضات التحرير. يمكن الحصول عليها من خلال action=query&prop=revisions&rvprop=timestamp. يتم تجاهل الصراعات الذاتية.
- النوع: timestamp (allowed formats)
- starttimestamp
الطابع الزمني عند بدء عملية التحرير، ويُستخدَم للكشف عن الحروب التحريرية، ويمكن الحصول عليها من خلال curtimestamp when beginning the edit process (e.g. when loading the page content to edit).
- النوع: timestamp (allowed formats)
- recreate
تجاوز أية أخطاء حول الصفحة التي تم حذفها في هذه الأثناء.
- النوع: منطقي (التفاصيل)
- createonly
لا تحرر الصفحة إذا كان موجودا بالفعل.
- النوع: منطقي (التفاصيل)
- nocreate
يحدث خطأ إذا كانت الصفحة غير موجودة.
- النوع: منطقي (التفاصيل)
- watch
- مهمل.
أضف الصفحة إلى لائحة مراقبة المستعمل الحالي
- النوع: منطقي (التفاصيل)
- unwatch
- مهمل.
إزالة الصفحة من قائمة المراقبة للمستخدم الحالي.
- النوع: منطقي (التفاصيل)
- watchlist
أضف الصفحة أو أزلها دون قيد أو شرط من قائمة مراقبة المستخدم الحالي ، أو استخدم التفضيلات (التي تم تجاهلها لمستخدمي الروبوت) أو لا تغير الساعة.
- إحدى القيم التالية: nochange، preferences، unwatch، watch
- الافتراضي: preferences
- md5
رمز الرقم MD5 للوسيط text، أو الوسائط prependtext وappendtext متسلسلة، في حالة التعيين، لن يتم التعديل ما لم يكن رمز الرقم صحيحا.
- prependtext
أضف هذا النص إلى بداية الصفحة أو القسم. يتجاوز نص .
- appendtext
أضف هذا النص إلى نهاية الصفحة أو القسم. تجاوز نص text.
استخدم section=new لإلحاق قسم جديد ، بدلاً من هذه المعلمة.
- undo
التراجع عن هذه المراجعة. تجاوز text, prependtext وappendtext.
- النوع: 2 = قائمة الأعداد الصحيحة
- 2 = القيم يجب ألا تقل عن ٠ .
- undoafter
التراجع عن جميع المراجعات من undo لهذه. إذا لم يتم التغيير، تراجع عن تعديل واحد فقط.
- النوع: 2 = قائمة الأعداد الصحيحة
- 2 = القيم يجب ألا تقل عن ٠ .
- 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
نموذج المحتوى للمحتوى الجديد.
- إحدى القيم التالية: css، javascript، json، text، unknown، wikitext
- token
تم استرداد رمز مميز "csrf" من action=query&meta=tokens
ينبغي دائما أن يُرسَل الرمز كوسيط أخير، أو على الأقل بعد الوسيط text.
- هذه المعلمة مطلوبة.
- returnto
عنوان الصفحة. إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) برابط URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه الرابط إلى الصفحة المحددة، بدلاً من الصفحة التي تم تعديلها.
- النوع: عنوان صفحة
- يقبل الصفحات غير الموجودة.
- returntoquery
معلمات استعلام عنوان URL (بعلامة "؟" ). إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) بعنوان URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه عنوان URL إلى صفحة تحتوي على معلمات الاستعلام المحددة.
- الافتراضي: (فارغ)
- returntoanchor
شظية عنوان URL (بعلامة # في البداية). إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) برابط URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه عنوان URL إلى صفحة تحتوي على الشظية المحددة.
- الافتراضي: (فارغ)
- عدل صفحة.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [فتح في ملعب]
- إضافة البادئة __NOTOC__ إلى الصفحة.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [فتح في ملعب]
- التراجع عن التعديلات 13579 خلال 13585 بملخص تلقائي.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [فتح في ملعب]