مساعدة 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 باستخدام الوسيط url.
إكمال عملية رفع سابقة فشلت بسبب تنبيهات، أو رُفعت على أجزاء أو خُزنت بطريقة أخرى في مخزن الرفع، باستخدام الوسيط filekey.

يرجى ملاحظة أن طلب HTTP POST ينبغي أن يُرفع بصيغة ملف (أي باستخدام multipart/form-data) عند إرسال file أو chunk.

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

معلمات محددة:

المعلمات العامة الأخرى متاحة.

filename: اسم الملف المستهدف.
comment: تحميل تعليق الرفع، يُستخدَم أيضا كنص الصفحة الأولي للملفات الجديدة إذا لم يتم تحديد text.; الافتراضي: (فارغ)
tags: غتيير الوسوم لتطبيقها على إدخال سجل الرفع ومراجعة صفحة الملف.; القيم (منفصلة مع | أو البديل):
text: النص الأولي للصفحة للملفات الجديدة.
watch: مهمل.; راقب الصفحة.; النوع: منطقي (التفاصيل)
watchlist: أضف الصفحة أو أزلها دون قيد أو شرط من قائمة مراقبة المستخدم الحالي ، أو استخدم التفضيلات (التي تم تجاهلها لمستخدمي الروبوت) أو لا تغير الساعة.; إحدى القيم التالية: nochange، preferences، watch; الافتراضي: preferences
ignorewarnings: تجاهل أية تحذيرات.; النوع: منطقي (التفاصيل)
file: محتويات الملف.; يجب نشرها كتحميل ملف باستخدام بيانات متعددة الأجزاء / النموذج.
url: مسار لجلب الملف منه.
filekey: المفتاح الذي يحدد التحميل السابق المخزن مؤقتا.
sessionkey: مهمل.; نفس filekey، تتم صيانته للتوافق مع الإصدارات السابقة.
stash: في حالة التعيين، سيخزن الخادم الملف مؤقتا بدلا من إضافته إلى المستودع.; النوع: منطقي (التفاصيل)
filesize: حجم ملف الرفع الكامل.; النوع: 2 = قائمة الأعداد الصحيحة; 2 = القيم يجب أن تكون بين ٠ ١٠٤٬٨٥٧٬٦٠٠ .
offset: إزاحة القطعة بالبايت.; النوع: 2 = قائمة الأعداد الصحيحة; 2 = القيم يجب ألا تقل عن ٠ .
chunk: محتويات القطعة.; يجب نشرها كتحميل ملف باستخدام بيانات متعددة الأجزاء / النموذج.
async: إجراء عمليات ملف كبيرة محتملة غير متزامنة عند الإمكان.; النوع: منطقي (التفاصيل)
checkstatus: فقط جلب حالة الرفع لمفتاح الملف المحدد.; النوع: منطقي (التفاصيل)
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 [فتح في ملعب]