مساعدة API ميدياويكي

هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.

وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

هذه الوحدة تتطلب صلاحيات القراءة.
هذه الوحدة تتطلب صلاحيات الكتابة.
هذه الوحدة تقبل طلبات POST فقط.
المصدر:MediaWiki
الترخيص: GPL-2.0-or-later

رفع ملف أو الحصول على حالة المرفوعات المعلقة.

تتوفر عدة طرق:

ارفع محتويات الملف مباشرة، باستخدام الوسيط file.
ارفع الملف على أجزاء باستخدام الوسائط filesize وchunk وoffset.
اجعل خادم ميدياويكي يقوم بجلب ملف من مسار، باستخدام الوسيط url.
أكمل عملية رفع سابقة فشلت بسبب التحذيرات، باستخدام الوسيط filekey.

لاحظ أنه يجب إجراء HTTP POST كرفع ملف (أي استخدام multipart/form-data) عند إرسال file.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

وسائط:

filename: اسم الملف المستهدف.
comment: تحميل تعليق الرفع، يُستخدَم أيضا كنص الصفحة الأولي للملفات الجديدة إذا لم يتم تحديد text.; الافتراضي: (فارغ)
tags: غتيير الوسوم لتطبيقها على إدخال سجل الرفع ومراجعة صفحة الملف.; القيم (منفصلة مع | أو البديل):
text: النص الأولي للصفحة للملفات الجديدة.
watch: مهمل.; راقب الصفحة.; Type: boolean (details)
watchlist: أضف الصفحة أو أزلها دون قيد أو شرط من قائمة مراقبة المستخدم الحالي ، أو استخدم التفضيلات (التي تم تجاهلها لمستخدمي الروبوت) أو لا تغير الساعة.; إحدى القيم التالية: nochange، preferences، watch; الافتراضي: preferences
ignorewarnings: تجاهل أية تحذيرات.; Type: boolean (details)
file: محتويات الملف.; يجب نشرها كتحميل ملف باستخدام بيانات متعددة الأجزاء / النموذج.
url: مسار لجلب الملف منه.
filekey: المفتاح الذي يحدد التحميل السابق المخزن مؤقتا.
sessionkey: مهمل.; نفس filekey، تتم صيانته للتوافق مع الإصدارات السابقة.
stash: في حالة التعيين، سيخزن الخادم الملف مؤقتا بدلا من إضافته إلى المستودع.; Type: boolean (details)
filesize: حجم ملف الرفع الكامل.; النوع: 2 = قائمة الأعداد الصحيحة; 2 = القيم يجب أن تكون بين ٠ ١٬٠٧٣٬٧٤١٬٨٢٤ .
offset: إزاحة القطعة بالبايت.; النوع: 2 = قائمة الأعداد الصحيحة; 2 = القيم يجب ألا تقل عن ٠ .
chunk: محتويات القطعة.; يجب نشرها كتحميل ملف باستخدام بيانات متعددة الأجزاء / النموذج.
async: إجراء عمليات ملف كبيرة محتملة غير متزامنة عند الإمكان.; Type: boolean (details)
checkstatus: فقط جلب حالة الرفع لمفتاح الملف المحدد.; Type: boolean (details)
token: تم استرداد رمز مميز "csrf" من action=query&meta=tokens; هذه المعلمة مطلوبة.

أمثلة:

رفع من مسار.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [فتح في ملعب]
أكمل الرفع الذي أخفق بسبب التحذيرات.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [فتح في ملعب]