MediaWiki-API-Hilfe

Spezial: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.

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

Parameter:

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.; Typ: boolisch (Einzelheiten)
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: Ignoriert Warnungen.; Typ: boolisch (Einzelheiten)
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.; Typ: boolisch (Einzelheiten)
filesize: Dateigröße des gesamten Uploads.; Der Wert muss zwischen 0 und 104.857.600 sein.; Typ: Ganzzahl
offset: Offset of chunk in bytes.; Der Wert darf nicht kleiner sein als 0.; Typ: Ganzzahl
chunk: Chunk contents.; Muss als Dateiupload mithilfe eines multipart/form-data-Formular bereitgestellt werden.
async: Make potentially large file operations asynchronous when possible.; Typ: boolisch (Einzelheiten)
checkstatus: Ruft nur den Hochladestatus für den angegebenen Dateischlüssel ab.; Typ: boolisch (Einzelheiten)
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]