MediaWiki-API-Hilfe

Dies ist eine automatisch generierte MediaWiki-API-Dokumentationsseite.

Dokumentation und Beispiele: https://www.mediawiki.org/wiki/API/de

action=upload

(main | upload)
  • Dieses Modul erfordert Leserechte.
  • Dieses Modul erfordert Schreibrechte.
  • Dieses Modul akzeptiert nur POST-Anfragen.
  • Quelle: MediaWiki
  • Lizenz: GPL-2.0+

Upload a file, or get the status of pending uploads.

Several methods are available:

  • Upload file contents directly, using the file parameter.
  • Upload the file in pieces, using the filesize, chunk, and offset parameters.
  • Have the MediaWiki server fetch a file from a URL, using the url parameter.
  • Complete an earlier upload that failed due to warnings, using the filekey parameter.

Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when sending the file.

Parameter:
filename

Ziel-Dateiname.

comment

Upload comment. Also used as the initial page text for new files if text is not specified.

Standard: (leer)
text

Initial page text for new files.

watch
Veraltet.

Die Seite beobachten.

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

Einer der folgenden Werte: watch, preferences, nochange
Standard: preferences
ignorewarnings

Ignore any warnings.

Type: boolean (details)
file

Dateiinhalte.

Muss als Dateiupload mithilfe eines multipart/form-data-Formular bereitgestellt werden.
url

URL, von der die Datei abgerufen werden soll.

filekey

Key that identifies a previous upload that was stashed temporarily.

sessionkey
Veraltet.

Same as filekey, maintained for backward compatibility.

stash

If set, the server will stash the file temporarily instead of adding it to the repository.

Type: boolean (details)
filesize

Filesize of entire upload.

Der Wert muss zwischen 0 und 536.870.912 sein.
Type: integer
offset

Offset of chunk in bytes.

Der Wert darf nicht kleiner sein als 0.
Type: integer
chunk

Chunk contents.

Muss als Dateiupload mithilfe eines multipart/form-data-Formular bereitgestellt werden.
async

Make potentially large file operations asynchronous when possible.

Type: boolean (details)
asyncdownload

Make fetching a URL asynchronous.

Type: boolean (details)
leavemessage

If asyncdownload is used, leave a message on the user talk page if finished.

Type: boolean (details)
statuskey

Fetch the upload status for this file key (upload by URL).

checkstatus

Only fetch the upload status for the given file key.

Type: boolean (details)
token

Ein „csrf“-Token abgerufen von action=query&meta=tokens

Dieser Parameter ist erforderlich.