MediaWiki-API-Hilfe

Dies ist eine automatisch generierte MediaWiki-API-Dokumentationsseite.

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. Wenn dieser nicht festgelegt ist und file verwendet wird, wird der dort angegebene Dateiname verwendet.
comment: Upload comment. Also used as the initial page text for new files if text is not set.; Standard: (leer)
tags: Auf den Datei-Logbuch-Eintrag und die Dateiseitenversion anzuwendende Änderungsmarkierungen.; Werte (mit | oder Alternative trennen):
text: Erster Seitentext für neue Dateien.
watch: Veraltet.; Die Seite beobachten.; Typ: boolesch (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.; Typ: boolesch (Details)
file: Dateiinhalt und weitere Details. Du musst entweder diesen Eintrag oder filekey oder url angeben.; Muss als Dateiupload mithilfe eines multipart/form-data-Formulars bereitgestellt werden.
url: URL, von der die Datei abgerufen werden soll. Du musst entweder diese Angabe oder file oder filekey angeben.
filekey: Schlüssel, der einen vorherigen Upload identifiziert, der vorübergehend gespeichert wurde. Du musst entweder dies oder file oder url angeben.
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.; Typ: boolesch (Details)
filesize: Dateigröße des gesamten Uploads.; Typ: Ganzzahl; Der Wert muss zwischen 0 und 629.145.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.; Typ: boolesch (Details)
checkstatus: Ruft nur den Hochladestatus für den angegebenen Dateischlüssel ab.; Typ: boolesch (Details)
autotext: Generate the file description page wikitext server-side from comment, license, copystatus and source, overriding the text parameter. Extensions may alter the generated text via the UploadForm:getInitialPageText hook. autotext exists to allow action=upload to match the behavior of Special:Upload and the importImages maintenance script.; Typ: boolesch (Details)
license: License selected for the upload. This is a template name. Only used together with autotext to generate the file description page wikitext.; Standard: (leer)
token: Ein „csrf“-Token abgerufen von action=query&meta=tokens; Dieser Parameter ist erforderlich.
uploadwizardpublish: Interner Parameter, der vom Hochladeassistenten festgelegt wird, um eine Veröffentlichung als von diesem stammend zu kennzeichnen.; Typ: boolesch (Details)
captchaid: CAPTCHA-Kennung der vorherigen Anfrage
captchaword: Antwort an das CAPTCHA

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]