واجهة برمجة التطبيقات:Filerevert

Filerevert
إرجاع ملف محدد إلى نسخة سابقة. لا يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
بادئة	لا شيء
حقوق مطلوبة	edit, upload
النشر فقط؟	نعم
مساعدة مولّدة	الحالي
النسخة التي أضيفت فيها	≥ 1.18

POST request to revert a file to an old version.

رمز

كي ترجع ملف ما إلى نسخة سابقة، يتطلب الأمر وجود رمز CSRF. رمز CSRF سيكون نفس الرمز لكل الصفحات، إلا أنه يتغير في كل مرة تسجل فيها الدخول. يمكن الحصول على رموز CSRF مستخدمًا action=query&meta=tokens عن طريق type=csrf‏ (MW 1.24+). أما بالنسبة للنسخ السابقة، يمكنك استخدام واجهة برمجة التطبيقات:Tokens (action) أو واجهة برمجة التطبيقات:معلومات للحصول على رمز تعديل.

المتغيرات

• filename: اسم الملف المستهدف، دون استخدام البادئة ملف: (أو File:).
• archivename: اسم الأرشيف للمراجعة المطلوب الرجوع إليها. يجب أن يشتمل هذا على الختم الزمني للمراجعة واسم الملف بالصيغة التالية: yyyyMMddhhmmss!filename يمكن الاطلاع على هذه المعلومات مستخدمًا Imageinfo حينما تكون قيمة iilimit أعلى من 1. حينما تنظر إلى صفحة أحد الملفات، لن تظهر الثواني؛ ويمكن العثور على اسم الأرشيف المطلوب عن طريق وضع مؤشر الفأرة على الصورة القديمة والنظر إلى اسم الملف المعروض. (لاحظ أن محرف «!» سوف يكون مكوّدًا لأغراض معرفات المواقع الموحدة وسيظهر بدلًا من ذلك في صيغة ‎%21.)
• token: رمز CSRF حصلت عليه حسب ما هو مذكور في قسم الرموز سالف الذكر. أحرص على تكويد التابعة +\ لتصبح %2B%5C
• comment: رفع تعليق.

أكواد الخطأ

خلاف الأمور المعتادة:

الكود	معلومات
missingtitle	الصفحة التي حددتها غير موجودة.
filerevert-badversion	لا توجد نسخة محلية سابقة لهذا الملف بالتاريخ المعطى.

مثال

إرجاع ملف Wiki.png إلى نسخة 15:27:40، 5 مارس/آذار 2011.

api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=0123456789012345678901234567890123456789%2b%5c [جربها في ApiSandbox]

النتيجة
{ "filerevert": { "result": "Success" } }

action=filerevert

(main | filerevert)

• This module requires read rights.
• This module requires write rights.
• This module only accepts POST requests.
• Source: MediaWiki
• License: GPL-2.0-or-later

Revert a file to an old version.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Filerevert

Specific parameters:

Other general parameters are available.

filename

Target filename, without the File: prefix.

This parameter is required.

comment

Upload comment.

Default: (empty)

archivename

Archive name of the revision to revert to.

This parameter is required.

token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.

Example:

Revert Wiki.png to the version of 2011-03-05T15:27:40Z.

api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=123ABC [open in sandbox]