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

Lade eine Datei hoch oder erhalte den Status ausstehender 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: Die Seite bedingungslos zur Beobachtungsliste des aktuellen Benutzers hinzufügen oder daraus entfernen, Einstellungen verwenden (wird für Bot-Benutzer ignoriert) oder die Beobachtung nicht ändern.; 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: Schlüssel, der einen vorherigen Upload identifiziert, der vorübergehend gespeichert wurde.
sessionkey: Veraltet.; Gleich wie filekey, wird aus Gründen der Abwärtskompatibilität beibehalten.
stash: Wenn festgelegt, legt der Server die Datei vorübergehend ab, anstatt sie zum Repository hinzuzufügen.; Type: boolean (details)
filesize: Dateigröße des gesamten Uploads.; Typ: Ganzzahl; Der Wert muss zwischen 0 und 104.857.600 liegen.
offset: Offset des Chunks in Bytes.; Typ: Ganzzahl; Der Wert darf nicht kleiner sein als 0.
chunk: Chunk-Inhalte.; Muss als Dateiupload mithilfe eines multipart/form-data-Formulars bereitgestellt werden.
async: Führe große Dateioperationen nach Möglichkeit asynchron aus.; 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]