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.

Es stehen mehrere Methoden zur Verfügung:

Direktes Hochladen der Dateiinhalte, indem der Parameter file verwendet wird.
Hochladen der Datei in Teilen, indem die Parameter filesize, chunk und offset verwendet werden.
Der MediaWiki-Server kann eine Datei von einer URL abrufen, indem der Parameter url verwendet wird.
Abschließen eines früheren Hochladevorgangs, der aufgrund von Warnungen fehlgeschlagen ist, in Teilen hochgeladen oder auf andere Weise im Upload-Stash gespeichert wurde, indem der Paramter filekey verwendet wird.

Beachte, dass der HTTP POST als Datei-Upload erfolgen muss (d. h. unter Verwendung von multipart/form-data), wenn file oder chunk gesenden werden.

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]