مساعدة 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
- مهمل.
راقب الصفحة.
- النوع: منطقية (التفاصيل)
- watchlist
إضافة أو إزالة الصفحة من قائمة مراقبة المستخدم الحالي أو استخدام التفضيلات أو عدم تغيير المراقبة بدون شروط.
- إحدى القيم التالية: watch، preferences، nochange
- الافتراضي: preferences
- ignorewarnings
تجاهل أية تحذيرات.
- النوع: منطقية (التفاصيل)
- file
محتويات الملف.
- يجب أن يتم نشره كرفع ملف باستخدام بيانات متعددة الأجزاء/النماذج.
- url
مسار لجلب الملف منه.
- filekey
المفتاح الذي يحدد التحميل السابق المخزن مؤقتا.
- sessionkey
- مهمل.
نفس filekey، تتم صيانته للتوافق مع الإصدارات السابقة.
- stash
في حالة التعيين، سيخزن الخادم الملف مؤقتا بدلا من إضافته إلى المستودع.
- النوع: منطقية (التفاصيل)
- filesize
حجم ملف الرفع الكامل.
- يجب أن تتراوح القيمة بين ٠ و١٠٤٬٨٥٧٬٦٠٠.
- النوع: عدد صحيح
- offset
إزاحة القطعة بالبايت.
- يجب ألا تقل القيمة عن ٠.
- النوع: عدد صحيح
- chunk
محتويات القطعة.
- يجب أن يتم نشره كرفع ملف باستخدام بيانات متعددة الأجزاء/النماذج.
- async
إجراء عمليات ملف كبيرة محتملة غير متزامنة عند الإمكان.
- النوع: منطقية (التفاصيل)
- checkstatus
فقط جلب حالة الرفع لمفتاح الملف المحدد.
- النوع: منطقية (التفاصيل)
- token
تم استرداد رمز مميز "csrf" من action=query&meta=tokens
- هذا الوسيط مطلوب.
![[فتح في ملعب]](/guide/%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}
![[فتح في ملعب]](/guide/%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}