مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/API
action=upload
- هذه الوحدة تتطلب صلاحيات القراءة.
- هذه الوحدة تتطلب صلاحيات الكتابة.
- هذه الوحدة تقبل طلبات POST فقط.
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
رفع ملف أو الحصول على حالة المرفوعات المعلقة.
تتوفر عدة طرق:
- ارفع محتويات الملف مباشرة، باستخدام الوسيط file.
- ارفع الملف على أجزاء باستخدام الوسائط filesize وchunk وoffset.
- اجعل خادم ميدياويكي يقوم بجلب ملف من مسار، باستخدام الوسيط url.
- أكمل عملية رفع سابقة فشلت بسبب التحذيرات، باستخدام الوسيط filekey.
لاحظ أنه يجب إجراء HTTP POST كرفع ملف (أي استخدام multipart/form-data) عند إرسال file.
- filename
اسم الملف المستهدف.
- comment
تحميل تعليق الرفع، يُستخدَم أيضا كنص الصفحة الأولي للملفات الجديدة إذا لم يتم تحديد text.
- الافتراضي: (فارغ)
- tags
غتيير الوسوم لتطبيقها على إدخال سجل الرفع ومراجعة صفحة الملف.
- القيم (منفصلة مع | أو البديل):
- text
النص الأولي للصفحة للملفات الجديدة.
- watch
- مهمل.
راقب الصفحة.
- Type: boolean (details)
- watchlist
إضافة أو إزالة الصفحة من قائمة مراقبة المستخدم الحالي أو استخدام التفضيلات أو عدم تغيير المراقبة بدون شروط.
- إحدى القيم التالية: nochange، preferences، watch
- Default: preferences
- ignorewarnings
تجاهل أية تحذيرات.
- Type: boolean (details)
- file
محتويات الملف.
- Must be posted as a file upload using multipart/form-data.
- url
مسار لجلب الملف منه.
- filekey
المفتاح الذي يحدد التحميل السابق المخزن مؤقتا.
- sessionkey
- مهمل.
نفس filekey، تتم صيانته للتوافق مع الإصدارات السابقة.
- stash
في حالة التعيين، سيخزن الخادم الملف مؤقتا بدلا من إضافته إلى المستودع.
- Type: boolean (details)
- filesize
حجم ملف الرفع الكامل.
- Type: integer
- The value must be between 0 and 104٬857٬600.
- offset
إزاحة القطعة بالبايت.
- Type: integer
- The value must be no less than 0.
- chunk
محتويات القطعة.
- Must be posted as a file upload using multipart/form-data.
- async
إجراء عمليات ملف كبيرة محتملة غير متزامنة عند الإمكان.
- Type: boolean (details)
- checkstatus
فقط جلب حالة الرفع لمفتاح الملف المحدد.
- Type: boolean (details)
- token
تم استرداد رمز مميز "csrf" من action=query&meta=tokens
- This parameter is required.
![[فتح في ملعب]](/%D8%AE%D8%A7%D8%B5:%D9%85%D9%84%D8%B9%D8%A8_%D8%A5%D9%8A%D9%87_%D8%A8%D9%8A_%D8%A2%D9%8A#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[فتح في ملعب]](/%D8%AE%D8%A7%D8%B5:%D9%85%D9%84%D8%B9%D8%A8_%D8%A5%D9%8A%D9%87_%D8%A8%D9%8A_%D8%A2%D9%8A#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}