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.

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): listingeditor
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
watchlistexpiry

Watchlist expiry timestamp. Omit this parameter entirely to leave the current expiry unchanged.

Type: expiry (details)
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 5.368.709.120 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]
Abgerufen von „https://de.wikivoyage.org/wiki/Spezial:API-Hilfe“