MediaWiki API hulp
Dit is een automatisch aangemaakte documentatiepagina over de API van MediaWiki.
Documentatie en voorbeelden: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=upload
- Voor deze module zijn leesrechten nodig.
- Voor deze module zijn schrijfrechten nodig.
- Deze module accepteert alleen POST-verzoeken.
- Bron: MediaWiki
- Licentie: GPL-2.0-or-later
Upload een bestand of bekijk de status van de uploads die in behandeling zijn.
Er zijn verscheidene methoden beschikbaar:
- De bestandsinhoud rechtstreeks uploaden met behulp van de parameter file.
- Het bestand in delen uploaden met behulp van de parameters filesize, chunk en offset.
- De MediaWiki-server een bestand van een URL laten ophalen met behulp van de parameter url.
- Met behulp van de parameter filekey een eerdere upload voltooien die vanwege waarschuwingen is mislukt.
Let op: bij het verzenden van het bestand file moet de HTTP POST worden uitgevoerd als bestandsupload (d.w.z. met behulp van multipart/form-data).
- filename
Doelbestandsnaam.
- comment
Opmerking bij de upload. Wordt ook gebruikt als de eerste paginatekst voor nieuwe bestanden als text niet is opgegeven.
- Standaard: (leeg)
Wijzigingslabels om toe te passen op de uploadlogboek-vermelding en de versie van de bestandspagina.
- Waarden (gescheiden met | of alternatief):
- text
Eerste paginatekst voor nieuwe bestanden.
- watch
- Verouderd.
De pagina volgen.
- Type: booleaans (details)
- watchlist
Of de pagina onvoorwaardelijk toevoegen aan of verwijderen uit de volglijst van de huidige gebruiker, of diens voorkeuren gebruiken (genegeerd voor robotgebruikers), of de volgstatus niet wijzigen.
- Een van de volgende waarden: nochange, preferences, watch
- Standaard: preferences
- ignorewarnings
Eventuele waarschuwingen negeren.
- Type: booleaans (details)
- file
Bestandsinhoud.
- Moet worden gepost als een geüpload bestand met behulp van multipart/form-data.
- url
URL om het bestand van op te halen.
- filekey
Sleutel die een eerdere upload identificeert die tijdelijk is opgeborgen.
- sessionkey
- Verouderd.
Hetzelfde als filekey, aangehouden voor achterwaartse compatibiliteit.
- stash
Als dit is ingesteld, zal de server het bestand tijdelijk opbergen in plaats van het aan de repository toe te voegen.
- Type: booleaans (details)
- filesize
Bestandsgroote van de hele upload.
- Type: geheel getal
- De waarde moet tussen 0 en 104.857.600 liggen.
- offset
Beginpunt van het fragment in bytes.
- Type: geheel getal
- De waarde mag niet kleiner zijn dan 0.
- chunk
Inhoud van het fragment.
- Moet worden gepost als een geüpload bestand met behulp van multipart/form-data.
- async
Maak potentieel grote bestandsbewerkingen indien mogelijk asynchroon.
- Type: booleaans (details)
- checkstatus
Haal alleen de uploadstatus op voor de opgegeven bestandssleutel.
- Type: booleaans (details)
- token
Een token “csrf” dat is verkregen uit action=query&meta=tokens
- Deze parameter is vereist.
- Uploaden vanaf een URL.
- api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [in de sandbox openen]
- Voltooi een upload die mislukt is vanwege waarschuwingen.
- api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [in de sandbox openen]
![[in de sandbox openen]](/index.php/Speciaal:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[in de sandbox openen]](/index.php/Speciaal:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}