API:Query/nl

Met de module  kunt u informatie ophalen over een wiki en de gegevens die erin zijn opgeslagen, zoals de wikitekst van een bepaalde pagina, de links en categorieën van een reeks pagina's, of het token dat u nodig hebt om.



Query modules
De querymodule heeft drie typen submodules (ook wel querymodules genoemd):

̽* van pagina's, inclusief revisies en inhoud.
 * over de wiki en de ingelogde gebruiker.
 * met pagina's die aan een bepaald criteria voldoen.

Voorbeelden


Voorbeeld 1: Pagina's specificeren
In tegenstelling tot meta- en lijstquerymodules werken alle eigenschapsquerymodules op een set pagina's die op een van de volgende manieren kunnen worden opgegeven:


 * Op naam met behulp van de parameter, bijvoorbeeld.
 * Op pagina-ID met behulp van de parameter, bijvoorbeeld.
 * Door revisie-ID met behulp van de parameter, bijvoorbeeld  . De meeste querymodules converteren revisie-id naar de bijbehorende pagina-id. Slechts  gebruikt daadwerkelijk de revisie-ID.
 * Een generator gebruiken.

Response


Voorbeeld 2: Titel normaliseren
Titel normalisatie converteert pagina-titels naar de canonieke vorm.

Dit betekent het eerste teken met een hoofdletter schrijven, onderstrepingstekens vervangen door spaties en namespace  wijzigen in de gelokaliseerde vorm die voor die wiki is gedefinieerd.

Response


Voorbeeld 3: Ontbrekende en ongeldige titels
Voor titels die niet bestaan of ongeldig zijn, is een kenmerk van  of   ingesteld in de response.

In uitvoerformaten die numerieke matrixsleutels ondersteunen, zullen ontbrekende of ongeldige titels negatieve pagina-id's krijgen.

In sommige gevallen kan een titel worden bekeken door een gebruiker, maar niet worden geopend door de API, zoals pagina's die de inhoud van een andere wiki ophalen. Deze titels hebben een attribuut  ingesteld in het antwoord.

Response


Voorbeeld 4: Vervolg queries
Wanneer niet alle gegevens worden geretourneerd in het antwoord op een query, is er een kenmerk van  om aan te geven dat er meer gegevens zijn.

Response
Als u meer gegevens wilt ophalen, voegt u de waarden toe aan de oorspronkelijke aanvraag:

Response


Voorbeeld 5: Batchcomplete
De API retourneert een element  om aan te geven dat alle gegevens voor de aanvraag zijn geretourneerd.

In het antwoord op de onderstaande voorbeeldquery is  opgenomen om aan te geven dat alle gegevens voor elk van de drie afbeeldingen zijn geretourneerd.

De volgende voortzetting begint met het retourneren van gegevens voor de volgende set van 3 afbeeldingen.

Response


Voorbeeld 6: Generatoren
Gebruik generatoren als u gegevens over een reeks pagina's wilt ophalen.

Als u bijvoorbeeld gegevens wilt ophalen over pagina's in een bepaalde categorie, combineert u de twee API-aanroepen in plaats van  uit te voeren en vervolgens opnieuw query's uit te voeren met   ingesteld op alle geretourneerde pagina's, in één door   te gebruiken.

Wanneer u een lijstmodule als generator gebruikt, hoeft u de pagina's niet op te geven.

Voor een eigenschapsmodule moet u echter de pagina's specificeren waarop de generator zal werken.

Als u bijvoorbeeld alle pagina's wilt laden waarnaar vanaf de hoofdpagina is gelinkt, gebruikt u.

Parameters die aan een generator worden doorgegeven, moeten worden voorafgegaan door een. Bij gebruik van, wordt het dan   in plaats van.

De onderstaande voorbeeldquery krijgt links en categorieën voor de eerste drie pagina's in de main namespace die begint met "Ba".

Response


Vervolg queries
Op zoekopdrachten zijn vaak meer resultaten beschikbaar dan in de oorspronkelijke vraag worden getoond. (Often this is because a query's result  has been reached.) In deze gevallen kunnen queries worden voortgezet. Meer informatie hierover staat bij.



Mogelijke waarschuwingen


Parameter geschiedenis

 * v1.34: Geïntroduceerd
 * v1.24: Geïntroduceerd  (NB: Ruwe voortzetting was het standaardgedrag tot v1.26)
 * v1.21: Geïntroduceerd



Aanvullende opmerkingen

 * Het opgeven van titels via  of   is beperkt tot 50 titels per zoekopdracht of 500 voor degenen met het recht.
 * Gebruik meerdere querymodules samen om in één verzoek te krijgen wat u nodig hebt, bijvoorbeeld.
 * Generators geven altijd pagina-titels door aan de zoekmodule. In tegenstelling tot lijsten (die standaard aanvullende gegevens kunnen bevatten), moeten generators geen informatie zelf uitvoeren, tenzij dit expliciet wordt gevraagd via de parameters van de zoekmodule.



Doorverwijzingen oplossen
Doorverwijzingen automatisch worden opgelost, zodat het doel van een doorverwijzing wordt geretourneerd in plaats van de opgegeven titel. Wanneer ze aanwezig zijn, bevatten ze altijd  en   attributen en mogelijk een   attribuut voor die doorverwijzingen die naar specifieke secties verwijzen.

Er kan zowel normalisatie als doorverwijzing plaatsvinden. In het geval van meerdere doorverwijzingen ze opgelost en in het geval van een circulaire doorverwijzing is er mogelijk geen pagina in het gedeelte 'pagina's' (zie ook hieronder). Doorverwijzing resolutie kan niet worden gebruikt in combinatie met de parameter  of met een generator die revids genereert; Als u dat doet, wordt een waarschuwing weergegeven en worden doorverwijzingen voor de opgegeven revids niet opgelost.

De onderstaande voorbeelden laten zien hoe de parameter  werkt.



Zie ook

 * - Snelstartgids
 * - Bevat informatie over het gebruik van de parameter.