MediaWiki-API-hjelp

Dette er en automatisk generert MediaWiki-API-dokumentasjonsside.

Dokumentasjon og eksempler: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Denne modulen krever lesetilgang.
Denne modulen krever skrivetilgang.
Denne modulen aksepterer bare POST forespørsler.
Kilde: MediaWiki
Lisens: GPL-2.0-or-later

Last opp en fil, eller hent statusen til vendende opplastinger.

Flere metoder er tilgjengelige:

Last opp filinnhold direkte med parameteren file.
Last opp filen i deler, med parameterne filesize, chunk og offset.
Få MediaWiki-tjeneren til å hente fila fra en URL, med parameteren url.
Fullfør en tidligere opplasting som mislyktes på grunn av advarsler med parameteren filekey.

Merk at HTTP POST må gjøres som en filopplasting (f.eks. med multipart/form-data) når man sender file.

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

Spesifikke parametre:

Andre generelle parametre er tilgjengelige.

filename: Målfilnavn.
comment: Opplastingskommentar. Brukes også som utgangspunkt for teksten til nye filer hvis text ikke angis.; Standard: (tom)
tags: Endringstagger som skal brukes på opplastingsloggoppføringen og i filsideversjonen.; Verdier (separer med | eller alternativ):
text: Første sidetekst for nye filer.
watch: Utgått.; Overvåk siden.; Type: boolsk (detaljer)
watchlist: Legg til eller fjern siden fra den gjeldende brukerens overvåkningsliste, bruk innstillinger (ignoreres for botbrukere) eller ikke endre overvåkning.; Én av følgende verdier: nochange, preferences, watch; Standard: preferences
ignorewarnings: Ignorer advarsler.; Type: boolsk (detaljer)
file: Filinnhold.; Må postes som en filopplasting med multipart/form-data.
url: URL fila skal hentes fra.
filekey: Nøkkel som identifiserer en tidligere opplasting som har blitt stashet midlertidig.
sessionkey: Utgått.; Samme som filekey, beholdes for bakoverkompatibilitet.
stash: Hvis denne er satt vil tjeneren lagre filen midlertidig i stedet for å legge den til i fillageret.; Type: boolsk (detaljer)
filesize: Filstørrelse for hele opplastingen.; Type: heltall; Verdien må være mellom 0 og 104 857 600.
offset: Forskyvning av delopplasting i byte.; Type: heltall; Verdien må være mindre enn 0.
chunk: Delopplastingens innhold.; Må postes som en filopplasting med multipart/form-data.
async: Gjør potensielt store filoperasjoner asynkront når det er mulig.; Type: boolsk (detaljer)
checkstatus: Bare hent opplastingsstatusen for den gitte filnøkkelen.; Type: boolsk (detaljer)
token: En «csrf»-nøkkel hentet fra action=query&meta=tokens; Denne parameteren er påkrevd.

Eksempler:

Last opp fra en URL.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [åpne i sandkasse]
Fullfør en opplasting som mislyktes på grunn av advarsler.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [åpne i sandkasse]