MediaWiki API help
This is an auto-generated MediaWiki Action API documentation page.
action=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.
- filename
Target filename. If not set, and file is used, then the filename from that will be used.
- comment
Upload comment. Also used as the initial page text for new files if text is not set.
- Predefinito: (vuoto)
Change tags to apply to the upload log entry and file page revision.
- Valori (separati da | o alternativa): AWB, Editor wikitesto 2017, JWB, Unione di crono, WPCleaner, aggiunta ripetuta di collegamenti esterni da parte di un nuovo utente, copyviol, domanda ad un tutor, modifica inattesa del tmp bozza, possibile-nui, prove-it, quick-responses, requests-wizard, ripristino-rapido, traduzionecontenuti, vandalismo
- 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
- 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 e altri dettagli. È necessario fornire questo oppure filekey o url.
- Must be posted as a file upload using multipart/form-data.
- url
URL to fetch the file from. You must supply either this or file or filekey.
- filekey
Key that identifies a previous upload that was stashed temporarily. You must supply either this or file or url.
- 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 5 368 709 120.
- 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)
- 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.
- Tipo: booleano (dettagli)
- license
License selected for the upload. This is a template name. Only used together with autotext to generate the file description page wikitext.
- Predefinito: (vuoto)
- token
Un token "csrf" recuperato da action=query&meta=tokens
- Questo parametro è obbligatorio.
- 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]
