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

(main | 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).

Specifieke parameters:
Er zijn nog andere algemene parameters beschikbaar.
filename

Doelbestandsnaam.

comment

Opmerking bij de upload. Wordt ook gebruikt als de eerste paginatekst voor nieuwe bestanden als text niet is opgegeven.

Standaard: (leeg)
tags

Wijzigingslabels om toe te passen op de uploadlogboek-vermelding en de versie van de bestandspagina.

Waarden (gescheiden met | of alternatief): AWB, convenient-discussions, huggle, tbxm, twinkle
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
watchlistexpiry

Vervaltijd voor de volglijst. Laat deze parameter volledig weg om de huidige vervaltijd ongewijzigd te laten.

Type: vervaldatum (details)
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 5.368.709.120 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.
Voorbeelden:
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]
Overgenomen van "https://nl.wikipedia.org/wiki/Speciaal:ApiHulp"