MediaWiki-API-Hilfe

Dies ist eine automatisch generierte MediaWiki-API-Dokumentationsseite.

Dokumentation und Beispiele: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

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

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.

Spezifische Parameter:
Weitere allgemeine Parameter sind verfügbar.
filename

Ziel-Dateiname.

comment

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

Standard: (leer)
tags

Auf den Datei-Logbuch-Eintrag und die Dateiseitenversion anzuwendende Änderungsmarkierungen.

Werte (mit | trennen oder Alternative):
text

Erster Seitentext für neue Dateien.

watch
Veraltet.

Die Seite beobachten.

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.

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

Ignoriert Warnungen.

Type: boolean (details)
file

Dateiinhalte.

Muss als Dateiupload mithilfe eines multipart/form-data-Formulars 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

Dateigröße des gesamten Uploads.

Typ: Ganzzahl
Der Wert muss zwischen 0 und 10.485.760 liegen.
offset

Offset of chunk in bytes.

Typ: Ganzzahl
Der Wert darf nicht kleiner sein als 0.
chunk

Chunk contents.

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

Make potentially large file operations asynchronous when possible.

Type: boolean (details)
checkstatus

Ruft nur den Hochladestatus für den angegebenen Dateischlüssel ab.

Type: boolean (details)
token

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

Dieser Parameter ist erforderlich.
Beispiele:
Von einer URL hochladen
api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [in Spielwiese öffnen]
Vervollständigt einen Upload, der aufgrund von Warnungen fehlgeschlagen ist.
api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [in Spielwiese öffnen]
Abgerufen von „https://demo.kiwithek.wien/index.php?title=Spezial:API-Hilfe“