واجهة برمجة التطبيقات:Filerevert
هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
Filerevert | ||
---|---|---|
إرجاع ملف محدد إلى نسخة سابقة. لا يمكن استخدام هذه الوحدة البرمجية بصفة مولّد. | ||
بادئة | لا شيء | |
حقوق مطلوبة | edit, upload | |
النشر فقط؟ | نعم | |
مساعدة مولّدة | الحالي | |
النسخة التي أضيفت فيها |
|
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"
}
}
|
أعمال التوثيق التالية هي نتاج صفحة Special: |
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.
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]