Jump to content

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

From mediawiki.org
This page is a translated version of the page API:Filerevert and the translation is 100% complete.

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.
النتيجة
{
  "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.

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.