Pomoč za API MediaWiki

To je samodejno ustvarjena stran za API MediaWiki.

Dokumentacija in zgledi: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Ta modul zahteva pravice branja.
Ta modul zahteva pravice pisanja.
Ta modul sprejema samo zahtevke POST.
Vir: MediaWiki
Licenca: GPL-2.0-or-later

Naložitev datoteke ali pridobitev statusa čakajočih nalaganj.

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.

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

Specifični parametri:

Na voljo so tudi drugi splošni parametri.

filename: Ime ciljne datoteke.
comment: Komentar nalaganja. Uporablja se tudi kot začetno besedilo strani za nove datoteke, če text ni določeno.; Privzeto: (prazno)
tags: Sprememba oznak za uzporabo pri dnevniškemu vnosu nalaganja in redakciji strani datoteke.; Vrednosti (ločene s | ali alternativa):
text: Začetno besedilo strani za nove datoteke.
watch: Opuščeno.; Opazuj stran.; Tip: Boolov (podrobnosti)
watchlist: Brezpogojno dodanje ali odstranitev strani z nadzornega seznama trenutnega uporabnika, uporaba nastavitev (prezrto za uporabnike botov) ali brez spremembe opazovanja.; Ena od naslednjih vrednosti: nochange, preferences, watch; Privzeto: preferences
ignorewarnings: Prezrtje vseh opozoril.; Tip: Boolov (podrobnosti)
file: Vsebina datoteke.; Posredovano mora biti kot naložena datoteka z »multipart/form-data«.
url: URL za pridobitev datoteke.
filekey: Ključ, ki identificira prejšnjo naloženo datoteko, ki je bila začasno shranjena.
sessionkey: Opuščeno.; Enako kot filekey, ohranjeno zaradi vzvratne združljivosti.
stash: Če je nastavljeno, bo strežnik datoteko začasno shranil, namesto da bi jo dodal v shrambo.; Tip: Boolov (podrobnosti)
filesize: Datotečna velikost celotnega nalaganja.; Vtipkajte: celo število; Vrednost mora biti med 0 in 104.857.600.
offset: Odmik bloka v bajtih.; Vtipkajte: celo število; The Vrednost ne sme biti manjša od 0.
chunk: Vsebina dela.; Posredovano mora biti kot naložena datoteka z »multipart/form-data«.
async: Kadar koli je mogoče, naj bodo operacije s potencialno velikimi datotekami asinhrone.; Tip: Boolov (podrobnosti)
checkstatus: Pridobitev samo stanja nalaganja za dani ključ datoteke.; Tip: Boolov (podrobnosti)
token: Žeton »csrf« pridobljen iz action=query&meta=tokens; Ta parameter je obvezen.

Zgleda:

Naložitev iz URL-ja: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [odpri v peskovniku]
Dokonča nalaganje, ki ni uspelo zaradi opozoril.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [odpri v peskovniku]