עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API

action=upload

(main | upload)

יחידה זו דורשת הרשאות קריאה.
היחידה הזאת דורשת הרשאות כתיבה.
יחידה זו מקבלת רק בקשות POST.
מקור: MediaWiki
רישיון: GPL-2.0+

העלאת קובץ, או קבלת מצב ההעלאות הממתינות.

יש מספר שיטות:

להעלות את הקובץ ישירות, באמצעות הפרמטר file.
להעלות את הקובץ בחלקים, באמצעות הפרמטרים filesize‏, chunk ו־offset.
לגרום לשרת מדיה־ויקי לאחזר את הקובץ מ־URL באמצעות הפרמטר url.
להשלים העלאה קודמת שנכשלה בשל אזהרות באמצעות הפרמטר filekey.

לתשומך לבך, יש לעשות את HTTP POST בתור העלאת קובץ (כלומר באמצעות multipart/form-data) בעת שליחת ה־file.

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

פרמטרים:

filename: שם קובץ היעד.
comment: הערת העלאה. משמש גם בתור טקסט הדף ההתחלתי עבור קבצים חדשים אם text אינו מצוין.; ברירת מחדל: (ריק)
tags: שינוי תגים להחלה לרשומות ההעלאה ולגרסאות דף הקובץ.; ערכים (מופרדים באמצעות "|" או or תו חלופי):
text: טקסט הדף ההתחלתי לקבצים חדשים.
watch: מיושן.; לעקוב אחרי הדף.; סוג: בוליאני (פרטים)
watchlist: הוספה או הסרה של הדף ללא תנאי מרשימת המעקב של המשתמש הנוכחי, להשתמש בהעדפות או לא לשנות את המעקב.; אחד מהערכים הבאים: watch, preferences, nochange; ברירת מחדל: preferences
ignorewarnings: להתעלם מכל האזהרות.; סוג: בוליאני (פרטים)
file: תוכן הקובץ.; חייב להישלח (posted) בתור העלאת קובץ באמצעות multipart/form-data.
url: URL לאחזור הקובץ.
filekey: מפתח שמזהה העלאה קודמת שהוסלקה באופן זמני.
sessionkey: מיושן.; אותו דבר כמו filekey, מושאר לצור תאימות אחורה.
stash: אם זה מוגדר, השרת יסליק זמנית את הקובץ במקום להוסיף אותו למאגר.; סוג: בוליאני (פרטים)
filesize: גודל הקובץ של כל ההעלאה.; הערך חייב להיות בין 0 ל־104,857,600.; סוג: מספר שלם
offset: היסט הפלח בבתים.; הערך לא יכולים להיות קטנים מ־0.; סוג: מספר שלם
chunk: תוכן החתיכה.; חייב להישלח (posted) בתור העלאת קובץ באמצעות multipart/form-data.
async: להפוך פעולות קבצים גדולות לאסינכרוניות כשאפשר.; סוג: בוליאני (פרטים)
checkstatus: לאחזר רק מצב העלאה עבור מפתח הקובץ שניתן.; סוג: בוליאני (פרטים)
token: אסימון "csrf" שאוחזר מ־action=query&meta=tokens; פרמטר זה נדרש.

דוגמאות:

להעלות מ־URL.: 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 [פתיחה בארגז חול]