MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)
  • Questo modulo richiede i diritti di lettura.
  • Questo modulo richiede i diritti di scrittura.
  • Questo modulo accetta solo richieste POST.
  • Fonte: MediaWiki
  • Licenza: 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.

Parametri specifici:
Sono disponibili altri parametri generali.
filename

Target filename.

comment

Upload comment. Also used as the initial page text for new files if text is not specified.

Predefinito: (vuoto)
tags

Change tags to apply to the upload log entry and file page revision.

Valori (separati da | o alternativa):
text

Initial page text for new files.

watch
Deprecato.

Aggiungi agli osservati speciali.

Tipo: booleano (dettagli)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.

Uno dei seguenti valori: nochange, preferences, watch
Default: preferences
watchlistexpiry

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

Type: expiry (details)
ignorewarnings

Ignore any warnings.

Tipo: booleano (dettagli)
file

Contenuto del file.

Must be posted as a file upload using multipart/form-data.
url

URL to fetch the file from.

filekey

Key that identifies a previous upload that was stashed temporarily.

sessionkey
Deprecato.

Same as filekey, maintained for backward compatibility.

stash

If set, the server will stash the file temporarily instead of adding it to the repository.

Tipo: booleano (dettagli)
filesize

Filesize of entire upload.

Type: integer
The value must be between 0 and 4 294 967 296.
offset

Offset of chunk in bytes.

Type: integer
The value must be no less than 0.
chunk

Chunk contents.

Must be posted as a file upload using multipart/form-data.
async

Make potentially large file operations asynchronous when possible.

Tipo: booleano (dettagli)
checkstatus

Only fetch the upload status for the given file key.

Tipo: booleano (dettagli)
token

Un token "csrf" recuperato da action=query&meta=tokens

This parameter is required.