API:FAQ/nl

Overzicht
Deze pagina bevat antwoorden op enkele veel gestelde vragen over de MediaWiki Action API. This page is intended for technical contributors and software developers who wish to understand and use the MediaWiki Action API.

Lees ook de. Daar worden enkele andere vragen beantwoordt en wordt er ook naar andere nuttige pagina's verwezen.



Over API's


Wat is een API?
API is een afkorting van Application Programming Interface. Via een API kunnen verschillende applicaties met elkaar communiceren. Sometimes an API allows an application to request an action to be done by the application which implements the API. Voor de mediawiki staat het voor webgebaseerde API's, die HTTP requests-response mechanismes gebruiken en JSON/XML gestructureerde gegevens aanmaken.



Wat is een REST API?
REST is een afkorting van REpresentational State Transfer. A set van principes of voorwaarden die een RESTful systeem definiëren. Een RESTful API &mdash; ook wel REST API  genoemd&mdash; volgt deze principes en de service is daardoor sneller, betrouwbaar en schaalbaar.



Wat kan een API doen?
Voorbeelden van gebruik API.



Waar kan ik meer informatie vinden over API's?
Hier zijn een paar bronnen:


 * API's begrijpen
 * Een introductie over API's
 * Wat is REST — Een uitleg voor beginners, Deel 1: Introductie

Algemeen


Wat is de MediaWiki Action API?
De MediaWiki Action API is een  RESTful  webservice die gebruikers toestaat bepaalde wiki-acties uit te voeren zoals het aanmaken van pagina's, authenticatie, parsing, zoeken, enz.



Waar kan de MediaWiki Action API voor worden gebruikt?
De MediaWiki Action API kan worden gebruikt voor:


 * toegang tot wiki-functies.
 * interactie met de wiki.
 * ophalen van meta-informatie over wiki's en openbare gebruikers.

De zijbalk aan de rechterkant geeft toegang tot veel functies die door de API worden ondersteund. Ook enkele Wikimedia projecten gebruiken de MediaWiki Action API.



Hoe gebruik ik de MediaWiki Action API?
HTTP requests worden gebruikt voor het aanroepen (call) van de Action API. Gedetailleerde instructies

Om de Action API uit te proberen:


 * Gebruik de Zandbak.
 * Schakel uw webbrowser omgeving voor ontwikkelaars in en bekijk de netwerk requests naar  als u iets op de wiki doet.



Wat is een module, een submodule en een parameter?
De MediaWiki Action API heeft meerdere modules die we gebruiken om verschillende taken uit te voeren. Technisch gezien is een module een subclass van ApiBase. Een module heeft parameters nodig. Deze parameters kunnen (maar dat hoeft niet) submodules zijn.

Bekijk het volgende request:

hier:


 * is een parameter van de hoofdmodule.
 * is een andere module. Het wordt de query module genoemd.
 * is een parameter van de query module.
 * is ook een module. Het kan een submodule van  genoemd worden.
 * is een parameter van de zoekmodule. Het bevat de zoektekst 'abc'.
 * is een parameter van de hoofdmodule.
 * is het uitvoerformaat.

Bekijk ook de Introductie en richtlijnen. Het beschrijft de submodules van de   module.



Hoe weet ik welke (sub)module ik moet aanroepen?
De MediaWiki Action API is groot en wordt met extensies zelfs nog groter. Een aantal manieren om uw API request uit te werken:


 * Kijk in de zijbalk naar de functie die u wilt gaan implementeren en volg de link naar informatie over welke modules aangeroepen moeten worden.
 * De documentatie van de API pagina's bevat een lijst van alle modules en submodules met korte beschrijvingen. U kunt beginnen met de hoofdmodule en de links naar verschillende submodules volgen. (Voeg  toe om de uitgebreidere versie te bekijken)



Zijn er voorbeelden met code hoe ik de API-modules kan gebruiken?
De API documentatie pagina's bevat een gedeelte met 'Voorbeelden' om aan te geven hoe de verschillende (sub)modules kunnen worden gebruikt. De automatisch gegenereerde documenten hebben ook voorbeelden achter de module beschrijvingen.

Bekijk de Mediawiki-API-demos voor stukjes code in Python en in JavaScript.



Hoe bepaal ik het uitvoerformaat?
Het uitvoerformaat is standaard JSON. De andere uitvoerformaten werden eerst ontraden en zijn later verwijderd.

In oude versies kan het uitvoerformaat nog worden opgegeven met  in de query string.

Bekijk gegevensformaten.



Heb ik een 'access token' nodig?
U heeft een 'access token' nodig als u wilt inloggen, gegevens wilt wijzigen, pagina's wilt bewerken of verplaatsen, ...

Bekijk API:Tokens of de zijbalk categorie 'Authenticatie'.



Hoe kan ik cross-site requests doen met de API?
U moet JSONP of CORS gebruiken om cross-site requests te doen in de MediaWiki.

Details Cross-site requests



Is er een limiet aan de query resultaten?
Ja, het hangt af van de query parameter. Het aantal resultaten voor  en   queries kan voor normale gebruikers maximaal 500 zijn. De API-pagina's bevatten informatie over deze limieten in de sectie 'Aanvullende notities' of de sectie 'Limieten'. Let op, sommige modules hanteren bij bepaalde condities strengere limieten.

Als u twijfelt wat u als limiet moet zetten of zoveel mogelijk resultaten wil, zet dan de limiet op.



Is er een limiet aan het aantal API-calls?
Nee, er is geen limiet, maar we bevelen aan om een redelijk aantal te doen om het blokkeren te voorkomen. Als u er erg veel wilt doen, neem vooraf contact op met de beheerders.

Zie: Etiquette.

<span id="Where_can_I_get_updates_about_the_MediaWiki_Action_API?">

Hoe krijg ik updates van de MediaWiki Action API?
U kunt u aanmelden voor deze specifieke mailinglijst met aankondigingen en nieuws over de API.

<span id="What_are_wiki_dumps_and_how_can_I_work_with_them?">

Wat zijn wiki-dumps?
Wikimedia’s data dumps zijn dumps van wiki verzamelingen, inhoud, metadata, zoekindexen, enz. Informatie over het gebruiken van dumps en openbare dumps.

<span id="Where_can_I_get_more_help?">

Waar kan ik meer ondersteuning krijgen?
Als u niet geholpen bent met de MediaWiki API documentatie of de gegenereerde documentatie pagina's, dan kunt u ondersteuning vinden op de volgende manieren.


 * Maak een Wikimedia account aan (als u die nog niet heeft) en begin een nieuw onderwerp op de API discussie pagina.
 * Stel uw vraag op:
 * IRC op het kanaal.
 * MediaWiki-API mailinglijst.

How can I create an API module in an extension?
API:Extensions will walk you through the complete process of creating an API module in an extension.

What is the internal structure of the API?
API:Implementation Strategy explains the implementation of the API machinery in MediaWiki Core.

How can I restrict the API usage?
To restrict the API usage, you can either restrict the use of write API or disable individual modules.

For instructions and examples, see API:Restricting API usage.

How can I allow/restrict users from modifying the wiki content using the API?
Users are allowed to modify the wiki content by default. To restrict, you have to set  in.

For more information, see API:Changing wiki content.

How do I detect an error?
If you encounter an error, the error response from the API will set the  HTTP header and return an error structure.

What does this error mean?
Find your error in the list of standard error messages to understand what the error means.

How do I file a bug/feature requests?
You can report bugs and file feature requests on Wikimedia's task tracking tool, Phabricator.

Note:


 * Add the MediaWiki-API project tag to your task.
 * If your report/request is offered by an extension, add that extension's project. (e.g. MediaWiki-extensions-AbuseFilter,  MediaWiki-extensions-FlaggedRevs, etc.)
 * Verify for duplicates before creating a new task.
 * Understand the task creation terms on Phabricator before proceeding.

See How to report a bug for more details.

Am I facing errors due to my API version?
If a website runs a different version of MediaWiki, it would also run a different version of the API. Some module parameters supported in one version might be deprecated (or removed) in others. Such parameters will throw an exception if used. The API pages document any such deprecations.

See the release notes for information regarding different API versions.