مساعدة 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.

وسائط:
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

هذه المعلمة مطلوبة.