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.

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

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 20.971.520 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]