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
- 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.
- 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 104.857.600 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.
- 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]
![[in Spielwiese öffnen]](/de/index.php?title=Spezial:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[in Spielwiese öffnen]](/de/index.php?title=Spezial:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}