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
- 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.
- 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.
- 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]