API-zandbak

Ga naar: navigatie, zoeken

Gebruik deze pagina om te experimenteren met de MediaWiki-API. Zie de API-documentatie voor verdere details over het gebruik van de API. Voorbeeld: hoe de inhoud van een Hoofdpagina ophalen. Selecteer een handeling om meer voorbeelden te zien. Hoewel dit een testfunctie is, kunnen sommige handelingen toch wijzigingen in de wiki maken.

main

Status: Alle functies die op deze pagina worden weergegeven horen te werken. Aan de API wordt actief gewerkt, en deze kan gewijzigd worden. Abonneer u op de e-maillijst mediawiki-api-announce voor meldingen over aanpassingen.

Foutieve verzoeken: als de API foutieve verzoeken ontvangt, wordt er geantwoord met een HTTP-header met de sleutel "MediaWiki-API-Error" en daarna worden de waarde van de header en de foutcode op dezelfde waarde ingesteld. Zie API: Errors and warnings voor meer informatie.

Testen: u kunt eenvoudig API-verzoeken testen.

action
 
Welke handeling uit te voeren.
format
json
 
De opmaak van de uitvoer.
maxlag
 
De maximale vertraging kan gebruikt worden als MediaWiki is geïnstalleerd op een databasecluster die gebruik maakt van replicatie. Om te voorkomen dat handelingen nog meer databasereplicatievertraging veroorzaken, kan deze parameter er voor zorgen dat de client wacht totdat de replicatievertraging lager is dan de aangegeven waarde. In het geval van buitensporige vertraging, wordt de foutcode maxlag teruggegeven met een bericht als Waiting for $host: $lag seconds lagged.
Zie Handboek: Maxlag parameter voor mee informatie.
smaxage
 
Stelt de s-maxage HTTP cache controle header in op het aangegeven aantal seconden. Foutmeldingen komen nooit in de cache.
maxage
 
Stelt de max-age HTTP cache controle header in op het aangegeven aantal seconden. Foutmeldingen komen nooit in de cache.
assert
 
Controleer of de gebruiker is aangemeld als user is meegegeven, en of de gebruiker het robotgebruikersrecht heeft als bot is meegegeven.
requestid
 
Elke waarde die hier gegeven wordt, wordt aan het antwoord toegevoegd. Dit kan gebruikt worden om verzoeken te onderscheiden.
servedby
 
Voeg de hostnaam van de server die de aanvraag heeft afgehandeld toe aan het antwoord.
curtimestamp
 
Huidige tijd aan het antwoord toevoegen.
origin
 
When accessing the API using a cross-domain AJAX request (CORS), set this to the originating domain. This must be included in any pre-flight request, and therefore must be part of the request URI (not the POST body). This must match one of the origins in the Origin header exactly, so it has to be set to something like https://en.wikipedia.org or https://meta.wikimedia.org. If this parameter does not match the Origin header, a 403 response will be returned. If this parameter matches the Origin header and the origin is whitelisted, an Access-Control-Allow-Origin header will be set.
uselang
 
Language to use for message translations. action=query&meta=siteinfo with siprop=languages returns a list of language codes, or specify user to use the current user's language preference, or specify content to use this wiki's content language.
format=json
Output data in JSON format.
callback
 
If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.
utf8
 
If specified, encodes most (but not all) non-ASCII characters as UTF-8 instead of replacing them with hexadecimal escape sequences. Default when formatversion is not 1.
ascii
 
If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.
formatversion
1
 

Uitvoeropmaak:

1
Achterwaarts compatibele opmaak (XML-stijl booleans, *-sleutels voor contentnodes, enzovoort).
2
Experimentele moderne opmaak. Details kunnen wijzigen!
latest
Gebruik de meest recente opmaak (op het moment 2), kan zonder waarschuwing wijzigen.
main
format=json