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, was uploaded in pieces, or stored otherwise in the upload stash, 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 or chunk.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

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; Predefinito: preferences
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 104 857 600.
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; Questo parametro è obbligatorio.

Esempi:

Carica da un URL.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [apri in una sandbox]
Complete an upload that failed due to warnings.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [apri in una sandbox]