API:Query/nl: Difference between revisions

Content deleted Content added

Inline

Latest revision as of 01:44, 12 October 2025

Deze pagina maakt deel uit van de MediaWiki Action API documentatie.

Met de module action=query 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 wiki-inhoud te wijzigen .

API documentatie

De volgende documentatie is de uitvoer van Special:ApiHelp/query, automatisch gegenereerd door de pre-release versie van MediaWiki die op deze site draait (MediaWiki.org).

action=query

(main | query)

This module requires read rights.
Source: MediaWiki
License: GPL-2.0-or-later

Fetch data from and about MediaWiki.

All data modifications will first have to use query to acquire a token to prevent abuse from malicious sites.

Specific parameters:

Other general parameters are available.

prop

Which properties to get for the queried pages.

categories: List all categories the pages belong to.
categoryinfo: Returns information about the given categories.
contributors: Get the list of registered contributors (including temporary users) and the count of anonymous contributors to a page.
deletedrevisions: Get deleted revision information.
duplicatefiles: List all files that are duplicates of the given files based on hash values.
extlinks: Returns all external URLs (not interwikis) from the given pages.
extracts: Returns plain-text or limited HTML extracts of the given pages.
fileusage: Find all pages that use the given files.
globalusage: Returns global image usage for a certain image.
imageinfo: Returns file information and upload history.
images: Returns all files contained on the given pages.
info: Get basic page information.
iwlinks: Returns all interwiki links from the given pages.
langlinks: Returns all interlanguage links from the given pages.
links: Returns all links from the given pages.
linkshere: Find all pages that link to the given pages.
mmcontent: Get the description and targets of a spamlist
pageimages: Returns information about images on the page, such as thumbnail and presence of photos.
pageprops: Get various page properties defined in the page content.
pageterms: Get the Wikidata terms (typically labels, descriptions and aliases) associated with a page via a sitelink.
pageviews: Shows per-page pageview data (the number of daily pageviews for each of the last pvipdays days).
redirects: Returns all redirects to the given pages.
revisions: Get revision information.
stashimageinfo: Returns file information for stashed files.
templates: Returns all pages transcluded on the given pages.
transcludedin: Find all pages that transclude the given pages.
transcodestatus: Get transcode status for a given file page.
videoinfo: Extends imageinfo to include video source (derivatives) information
wbentityusage: Returns all entity IDs used in the given pages.
flowinfo: Deprecated. Get basic Structured Discussions information about a page.
cirrusbuilddoc: Internal. Dump of a CirrusSearch article document from the database servers
cirruscompsuggestbuilddoc: Internal. Dump of the document used by the completion suggester
cirrusdoc: Internal. Dump of a CirrusSearch article document from the search servers
description: Internal. Get a short description a.k.a. subtitle explaining what the target page is about.
mapdata: Internal. Request all Kartographer map data for the given pages

Values (separate with | or alternative): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, extracts, fileusage, globalusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, mmcontent, pageimages, pageprops, pageterms, pageviews, redirects, revisions, stashimageinfo, templates, transcludedin, transcodestatus, videoinfo, wbentityusage, flowinfo, cirrusbuilddoc, cirruscompsuggestbuilddoc, cirrusdoc, description, mapdata

list

Which lists to get.

abusefilters: Show details of the abuse filters.
abuselog: Show events that were caught by one of the abuse filters.
allcategories: Enumerate all categories.
alldeletedrevisions: List all deleted revisions by a user or in a namespace.
allfileusages: List all file usages, including non-existing.
allimages: Enumerate all images sequentially.
alllinks: Enumerate all links that point to a given namespace.
allpages: Enumerate all pages sequentially in a given namespace.
allredirects: List all redirects to a namespace.
allrevisions: List all revisions.
alltransclusions: List all transclusions (pages embedded using {{x}}), including non-existing.
allusers: Enumerate all registered users.
backlinks: Find all pages that link to the given page.
betafeatures: List all BetaFeatures
blocks: List all blocked users and IP addresses.
categorymembers: List all pages in a given category.
centralnoticeactivecampaigns: Get a list of currently active campaigns with start and end dates and associated banners.
centralnoticelogs: Get a log of campaign configuration changes.
checkuserlog: Get entries from the CheckUser log.
codexicons: Get Codex icons
communityrequests-wishes: Get a list of wishes from the Community Wishlist.
embeddedin: Find all pages that embed (transclude) the given title.
extdistrepos: Returns the list of repositories supported by ExtensionDistributor
exturlusage: Enumerate pages that contain a given URL.
filearchive: Enumerate all deleted files sequentially.
gadgetcategories: Returns a list of gadget sections.
gadgets: Returns a list of gadgets used on this wiki.
globalallusers: Enumerate all global users.
globalblocks: List all globally blocked IP addresses and accounts. Note: Users that are locked using CentralAuth are not included in this list unless also globally blocked.
globalgroups: Enumerate all global groups.
globalrenamequeue: List requests in the global rename queue.
globalusers: Get information about a list of global users.
imageusage: Find all pages that use the given image title.
iwbacklinks: Find all pages that link to the given interwiki link.
langbacklinks: Find all pages that link to the given language link.
linterrors: Get a list of lint errors
logevents: Get events from logs.
messagecollection: Query MessageCollection about translations.
mostviewed: Lists the most viewed pages (based on last day's pageview count).
mystashedfiles: Get a list of files in the current user's upload stash.
pagecollectionsmetadata: Fetch page collection information for the given title.
pagepropnames: List all page property names in use on the wiki.
pageswithprop: List all pages using a given page property.
prefixsearch: Perform a prefix search for page titles.
protectedtitles: List all titles protected from creation.
querypage: Get a list provided by a QueryPage-based special page.
random: Get a set of random pages.
recentchanges: Enumerate recent changes.
search: Perform a full text search.
tags: List change tags.
threads: Show details of LiquidThreads threads.
trackingcategories: Enumerate all existing tracking categories defined in Special:TrackingCategories. A tracking category exists if it contains pages or if its category page exists.
usercontribs: Get all edits by a user.
users: Get information about a list of users.
watchlist: Get recent changes to pages in the current user's watchlist.
watchlistraw: Get all pages on the current user's watchlist.
wblistentityusage: Returns all pages that use the given entity IDs.
wikisets: Enumerate all wiki sets.
checkuser: Deprecated. This API has been disabled by the site administrators. Querying the API will return no data. Check which IP addresses are used by a given username or which usernames are used by a given IP address.
deletedrevs: Deprecated. list=deletedrevs has been deprecated. Please use prop=deletedrevisions or list=alldeletedrevisions instead.
List deleted revisions.
extdistbranches: Internal. Returns the list of branches for a repository supported by ExtensionDistributor
messagegroupsubscription: Internal. List message groups the current user is subscribed to.
readinglistentries: Internal. List the pages of a certain list.

Values (separate with | or alternative): abusefilters, abuselog, allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, betafeatures, blocks, categorymembers, centralnoticeactivecampaigns, centralnoticelogs, checkuserlog, codexicons, communityrequests-wishes, embeddedin, extdistrepos, exturlusage, filearchive, gadgetcategories, gadgets, globalallusers, globalblocks, globalgroups, globalrenamequeue, globalusers, imageusage, iwbacklinks, langbacklinks, linterrors, logevents, messagecollection, mostviewed, mystashedfiles, pagecollectionsmetadata, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, threads, trackingcategories, usercontribs, users, watchlist, watchlistraw, wblistentityusage, wikisets, checkuser, deletedrevs, extdistbranches, messagegroupsubscription, readinglistentries

Maximum number of values is 50 (500 for clients that are allowed higher limits).

meta

Which metadata to get.

allmessages: Return messages from this site.
authmanagerinfo: Retrieve information about the current authentication status.
babel: Get information about what languages the user knows
communityconfiguration: Read the community configuration
featureusage: Get a summary of logged API feature usages for a user agent.
filerepoinfo: Return meta information about image repositories configured on the wiki.
globalpreferences: Retrieve global preferences for the current user.
globalrenamestatus: Show information about global renames that are in progress.
globaluserinfo: Show information about a global user.
languageinfo: Return information about available languages.
languagestats: Query language stats.
linterstats: Get number of lint errors in each category
managemessagegroups: Fetch possible renames for a message in a group during imports
messagegroups: Return information about message groups.
messagegroupstats: Query message group stats.
messagetranslations: Query all translations for a single message.
notifications: Get notifications waiting for the current user.
siteinfo: Return general information about the site.
siteviews: Shows sitewide pageview data (daily pageview totals for each of the last pvisdays days).
tokens: Gets tokens for data-modifying actions.
unreadnotificationpages: Get pages for which there are unread notifications for the current user.
userinfo: Get information about the current user.
wikibase: Get information about the Wikibase client and the associated Wikibase repository.
checkuserformattedblockinfo: Internal. Return formatted block details for sitewide blocks affecting the current user.
readinglists: Internal. List or filter the user's reading lists and show metadata about them.

Values (separate with | or alternative): allmessages, authmanagerinfo, babel, communityconfiguration, featureusage, filerepoinfo, globalpreferences, globalrenamestatus, globaluserinfo, languageinfo, languagestats, linterstats, managemessagegroups, messagegroups, messagegroupstats, messagetranslations, notifications, siteinfo, siteviews, tokens, unreadnotificationpages, userinfo, wikibase, checkuserformattedblockinfo, readinglists

indexpageids

Include an additional pageids section listing all returned page IDs.

Type: boolean (details)

export

Export the current revisions of all given or generated pages.

Type: boolean (details)

exportnowrap

Return the export XML without wrapping it in an XML result (same format as Special:Export). Can only be used with query+export.

Type: boolean (details)

exportschema

Target the given version of the XML dump format when exporting. Can only be used with query+export.

One of the following values: 0.10, 0.11

Default: 0.11

iwurl

Whether to get the full URL if the title is an interwiki link.

Type: boolean (details)

continue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

rawcontinue

Return raw query-continue data for continuation.

Type: boolean (details)

titles

A list of titles to work on.

Separate values with | or alternative.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

pageids

A list of page IDs to work on.

Type: list of integers

Separate values with | or alternative.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

revids

A list of revision IDs to work on. Note that almost all query modules will convert revision IDs to the corresponding page ID and work on the latest revision instead. Only prop=revisions uses exact revisions for its response.

Type: list of integers

Separate values with | or alternative.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

generator

Get the list of pages to work on by executing the specified query module.

Note: Generator parameter names must be prefixed with a "g", see examples.

allcategories: Enumerate all categories.
alldeletedrevisions: List all deleted revisions by a user or in a namespace.
allfileusages: List all file usages, including non-existing.
allimages: Enumerate all images sequentially.
alllinks: Enumerate all links that point to a given namespace.
allpages: Enumerate all pages sequentially in a given namespace.
allredirects: List all redirects to a namespace.
allrevisions: List all revisions.
alltransclusions: List all transclusions (pages embedded using {{x}}), including non-existing.
backlinks: Find all pages that link to the given page.
categories: List all categories the pages belong to.
categorymembers: List all pages in a given category.
deletedrevisions: Get deleted revision information.
duplicatefiles: List all files that are duplicates of the given files based on hash values.
embeddedin: Find all pages that embed (transclude) the given title.
exturlusage: Enumerate pages that contain a given URL.
fileusage: Find all pages that use the given files.
images: Returns all files contained on the given pages.
imageusage: Find all pages that use the given image title.
iwbacklinks: Find all pages that link to the given interwiki link.
langbacklinks: Find all pages that link to the given language link.
links: Returns all links from the given pages.
linkshere: Find all pages that link to the given pages.
messagecollection: Query MessageCollection about translations.
mostviewed: Lists the most viewed pages (based on last day's pageview count).
pageswithprop: List all pages using a given page property.
prefixsearch: Perform a prefix search for page titles.
protectedtitles: List all titles protected from creation.
querypage: Get a list provided by a QueryPage-based special page.
random: Get a set of random pages.
recentchanges: Enumerate recent changes.
redirects: Returns all redirects to the given pages.
revisions: Get revision information.
search: Perform a full text search.
templates: Returns all pages transcluded on the given pages.
trackingcategories: Enumerate all existing tracking categories defined in Special:TrackingCategories. A tracking category exists if it contains pages or if its category page exists.
transcludedin: Find all pages that transclude the given pages.
watchlist: Get recent changes to pages in the current user's watchlist.
watchlistraw: Get all pages on the current user's watchlist.
wblistentityusage: Returns all pages that use the given entity IDs.
readinglistentries: Internal. List the pages of a certain list.

One of the following values: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, messagecollection, mostviewed, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, trackingcategories, transcludedin, watchlist, watchlistraw, wblistentityusage, readinglistentries

redirects

Automatically resolve redirects in query+titles, query+pageids, and query+revids, and in pages returned by query+generator.

Type: boolean (details)

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include ban, crh, en, gan, iu, ku, mni, sh, shi, sr, tg, tly, uz, wuu, zgh and zh.

Type: boolean (details)

Examples:

Fetch site info and revisions of MediaWiki.: api.php?action=query&prop=revisions&meta=siteinfo&titles=MediaWiki&rvprop=user|comment&continue= [open in sandbox]
Fetch revisions of pages beginning with API/.: api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue= [open in sandbox]

Query modules

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

Meta informatie over de wiki en de ingelogde gebruiker.

̽* Eigenschappen van pagina's, inclusief revisies en inhoud.

Lijsten 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 titles, bijvoorbeeld titles=Foo|Bar|Main_Page.
Op pagina-ID met behulp van de parameter pageids, bijvoorbeeld pageids=123|456|75915.
Door revisie-ID met behulp van de parameter revids, bijvoorbeeld revids=478198|54872|54894545. De meeste querymodules converteren revisie-id naar de bijbehorende pagina-id. Slechts prop=revisions gebruikt daadwerkelijk de revisie-ID.
Een generator gebruiken.

GET request

api.php?action=query&revids=347819|5487|548945&format=json&formatversion=2 [probeer het in de ApiSandbox]

Response

{
    "batchcomplete": true,
    "query": {
        "pages": [
            {
                "pageid": 1130,
                "ns": 0,
                "title": "Avicenna"
            },
            {
                "pageid": 17412,
                "ns": 0,
                "title": "Klein bottle"
            },
            {
                "pageid": 33642,
                "ns": 0,
                "title": "Warrant"
            }
        ]
    }
}

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.

Eventuele regeleinden in paginatitels (\n) veroorzaken vreemd gedrag en moeten eerst worden verwijderd.

GET request

api.php?action=query&titles=Project:articleA|article_B&format=json&formatversion=2 [probeer het in de ApiSandbox]

Response

{
    "batchcomplete": true,
    "query": {
        "normalized": [
            {
                "fromencoded": false,
                "from": "Project:articleA",
                "to": "Wikipedia:ArticleA"
            },
            {
                "fromencoded": false,
                "from": "article_B",
                "to": "Article B"
            }
        ],
        "pages": [
            {
                "ns": 0,
                "title": "Article B",
                "missing": true
            },
            {
                "ns": 4,
                "title": "Wikipedia:ArticleA",
                "missing": true
            }
        ]
    }
}

Voorbeeld 3: Ontbrekende en ongeldige titels

Voor titels die niet bestaan of ongeldig zijn, is een kenmerk van missing of invalid 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 known ingesteld in het antwoord.

GET request

api.php?action=query&titles=Doesntexist|Main%20Page|Talk:&format=json&formatversion=2 [probeer het in de ApiSandbox]

Response

{
    "batchcomplete": true,
    "query": {
        "pages": [
            {
                "ns": 0,
                "title": "Doesntexist",
                "missing": true
            },
            {
                "title": "Talk:",
                "invalidreason": "The requested page title is empty or contains only the name of a namespace.",
                "invalid": true
            },
            {
                "pageid": 15580374,
                "ns": 0,
                "title": "Main Page"
            }
        ]
    }
}

Voorbeeld 4: Vervolg queries

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

GET request

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2 [probeer het in de ApiSandbox]

Response

{
    "continue": {
        "accontinue": "List_of_largest_companies_in_Sri_Lanka",
        "continue": "-||"
    },
    "query": {
        "allcategories": [
            {
                "category": "List of BioWare characters"
            },
            {
                "category": "List of Harlequin Romance novels"
            },
            {
                "category": "List of MPs elected in UK elections templates"
            },
            {
                "category": "List of Metamorphoses characters"
            },
            {
                "category": "List of Rockstar Games characters"
            },
            {
                "category": "List of Star Trek awards and nominations"
            },
            {
                "category": "List of Swedish films of the 2020s"
            },
            {
                "category": "List of association football clubs in the Republic of Ireland templates"
            },
            {
                "category": "List of awards and nominations received by Aleksej Pechkuroy"
            },
            {
                "category": "List of cabinet templates"
            }
        ]
    }
}

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

GET request

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2&accontinue=List_of_largest_companies_in_Sri_Lanka&continue=-|| [probeer het in de ApiSandbox]

Response

{
    "batchcomplete": true,
    "query": {
        "allcategories": [
            {
                "category": "List of largest companies in Sri Lanka"
            },
            {
                "category": "List of longest beaches of the world"
            },
            {
                "category": "List of ministers by ministry of Bangladesh"
            },
            {
                "category": "List of people from Palm Beach, Florida"
            },
            {
                "category": "List of video game characters"
            }
        ]
    }
}

Voorbeeld 5: Batchcomplete

De API retourneert een element batchcomplete om aan te geven dat alle gegevens voor de aanvraag zijn geretourneerd. MW 1.25+

In het antwoord op de onderstaande voorbeeldquery is batchcomplete 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.

GET request

api.php?action=query&list=allimages&ailimit=3&format=json&formatversion=2 [probeer het in de ApiSandbox]

Response

{
  "batchcomplete": true,
  "continue": {
    "aicontinue": "20020822143445|Do_You_Want_to_Know_a_Secret_(Beatles_song_-_sample).ogg",
    "continue": "-||"
  },
  "query": {
    "allimages": [
      {
        "name": "Simon_and_Garfunkel_-_Mrs_Robinson.ogg",
        "timestamp": "2002-08-04T19:55:17Z",
        "url": "https://upload.wikimedia.org/wikipedia/en/6/64/Simon_and_Garfunkel_-_Mrs_Robinson.ogg",
        "descriptionurl": "https://en.wikipedia.org/wiki/File:Simon_and_Garfunkel_-_Mrs_Robinson.ogg",
        "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=67723",
        "ns": 6,
        "title": "File:Simon and Garfunkel - Mrs Robinson.ogg"
      },
      {
        "name": "Simon_and_Garfunkel_-_Scarborough_Fair.ogg",
        "timestamp": "2002-08-04T20:01:36Z",
        "url": "https://upload.wikimedia.org/wikipedia/en/c/c1/Simon_and_Garfunkel_-_Scarborough_Fair.ogg",
        "descriptionurl": "https://en.wikipedia.org/wiki/File:Simon_and_Garfunkel_-_Scarborough_Fair.ogg",
        "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=67779",
        "ns": 6,
        "title": "File:Simon and Garfunkel - Scarborough Fair.ogg"
      },
      {
        "name": "Beatles_please_me.ogg",
        "timestamp": "2002-08-22T14:34:00Z",
        "url": "https://upload.wikimedia.org/wikipedia/en/e/ee/Beatles_please_me.ogg",
        "descriptionurl": "https://en.wikipedia.org/wiki/File:Beatles_please_me.ogg",
        "descriptionshorturl": "https://en.wikipedia.org/w/index.php?curid=74826",
        "ns": 6,
        "title": "File:Beatles please me.ogg"
      }
    ]
  }
}

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 list=categorymembers uit te voeren en vervolgens opnieuw query's uit te voeren met pageids ingesteld op alle geretourneerde pagina's, in één door generator=categorymembers 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 generator=links&titles=Main%20Page.

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

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

GET request

api.php?action=query&generator=allpages&gaplimit=3&gapfrom=Ba&prop=links|categories&format=json&formatversion=2 [probeer het in de ApiSandbox]

Response

{
     "continue": {
         "plcontinue": "14977970|0|Kirkwall_Ba_game",
         "continue": "||categories"
     },
     "query": {
         "pages": [
             {
                 "pageid": 98178,
                 "ns": 0,
                 "title": "Ba",
                 "links": [
                     {
                         "ns": 0,
                         "title": "BA"
                     },
                     {
                         "ns": 4,
                         "title": "Wikipedia:Mainspace"
                     },
                     {
                         "ns": 4,
                         "title": "Wikipedia:Naming conventions (capitalization)"
                     },
                     {
                         "ns": 4,
                         "title": "Wikipedia:Protection policy"
                     },
                     {
                         "ns": 4,
                         "title": "Wikipedia:Redirect"
                     },
                     {
                         "ns": 10,
                         "title": "Template:R from miscapitalisation"
                     },
                     {
                         "ns": 10,
                         "title": "Template:R from modification"
                     },
                     {
                         "ns": 10,
                         "title": "Template:R to disambiguation page"
                     },
                     {
                         "ns": 14,
                         "title": "Category:Redirects from ambiguous terms"
                     },
                     {
                         "ns": 14,
                         "title": "Category:Redirects from other capitalisations"
                     }
                 ],
                 "categories": [
                     {
                         "ns": 14,
                         "title": "Category:Redirects from ambiguous terms"
                     },
                     {
                         "ns": 14,
                         "title": "Category:Redirects from other capitalisations"
                     },
                     {
                         "ns": 14,
                         "title": "Category:Unprintworthy redirects"
                     }
                 ]
             },
             {
                 "pageid": 14977970,
                 "ns": 0,
                 "title": "Ba'"
             },
             {
                 "pageid": 33351890,
                 "ns": 0,
                 "title": "Ba'Al Shem Tov"
             }
         ]
     }
}

Vervolg queries

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

Mogelijke waarschuwingen


Waarschuwing	Oorzaak
Er is geen ondersteuning voor speciale pagina's geïmplementeerd.	Treedt op een titel in de Special: of Media: namespace wordt gegeven. Deze pagina's kunnen niet worden opgevraagd.
Bij gebruik van de parameter `revids` is het niet mogelijk doorverwijzingen te volgen. Eventuele doorverwijzingen waarnaar `revids` verwijst zijn niet gevolgd.	Gegenereerd als de parameter `redirect` wordt gebruikt in een query die pagina's opgeeft met `revids`.

Parameter geschiedenis

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

Aanvullende opmerkingen

Het opgeven van titels via titles of pageids is beperkt tot 50 titels per zoekopdracht of 500 voor degenen met het recht apihighlimits.
Gebruik meerdere querymodules samen om in één verzoek te krijgen wat u nodig hebt, bijvoorbeeld prop=info|revisions&list=backlinks|embeddedin|allimages&meta=userinfo.
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 from en to attributen en mogelijk een tofragment attribuut voor die doorverwijzingen die naar specifieke secties verwijzen.

Er kan zowel normalisatie als doorverwijzing plaatsvinden. In het geval van meerdere doorverwijzingen worden die doorlopen, in het geval van een circulaire doorverwijzing is er mogelijk geen pagina in het gedeelte 'pagina's' (zie verzoek voorbeeld). Doorverwijzing resolutie kan niet worden gebruikt in combinatie met de parameter revids= 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 redirects werkt.

Gebruik parameter "redirects". "Main page" is een doorverwijzing naar "Main Page"

api.php?action=query&titles=Main%20page&redirects&format=json&formatversion=2 [probeer het in de ApiSandbox]

Resultaat
{ "batchcomplete": true, "query": { "redirects": [ { "from": "Main page", "to": "Main Page" } ], "pages": [ { "pageid": 15580374, "ns": 0, "title": "Main Page" } ] } }

Dezelfde aanvraag, maar zonder de parameter "redirects".

api.php?action=query&titles=Main%20page&format=json&formatversion=2 [probeer het in de ApiSandbox]

Resultaat
{ "batchcomplete": true, "query": { "pages": [ { "pageid": 217225, "ns": 0, "title": "Main page" } ] } }

Zonder "redirects" wilt u misschien prop=info gebruiken om de status van de doorverwijzing te krijgen.

api.php?action=query&titles=Main%20page&prop=info&formatversion=2 [probeer het in de ApiSandbox]

Resultaat

{
    "batchcomplete": true,
    "query": {
        "pages": [
            {
                "pageid": 217225,
                "ns": 0,
                "title": "Main page",
                "contentmodel": "wikitext",
                "pagelanguage": "en",
                "pagelanguagehtmlcode": "en",
                "pagelanguagedir": "ltr",
                "touched": "2017-12-17T02:02:05Z",
                "lastrevid": 777924062,
                "length": 170,
                "redirect": true
            }
        ]
    }
}

Aanvraag met een sectie link. "Wikipedia:!--" is een doorverwijzing naar "Wikipedia:Manual of Style#Invisible comments"

api.php?action=query&titles=Wikipedia:!--&redirects&format=json&formatversion=2 [probeer het in de ApiSandbox]

Resultaat

{
    "batchcomplete": true,
    "query": {
        "redirects": [
            {
                "from": "Wikipedia:!--",
                "to": "Wikipedia:Manual of Style",
                "tofragment": "Invisible comments"
            }
        ],
        "pages": [
            {
                "pageid": 33697,
                "ns": 4,
                "title": "Wikipedia:Manual of Style"
            }
        ]
    }
}

Hier is een geval van een circulaire doorverwijzing: Page1 → Page2 → Page3 → Page1. In dit voorbeeld wordt ook een niet-genormaliseerde naam 'page1' gebruikt.

api.php?action=query&titles=page1&redirects&format=json&formatversion=2 [probeer het in de ApiSandbox]

Resultaat

{
    "batchcomplete": true,
    "query": {
        "normalized": [
            {
                "fromencoded": false,
                "from": "page1",
                "to": "Page1"
            }
        ],
        "redirects": [
            {
                "from": "Page1",
                "to": "Page2"
            },
            {
                "from": "Page2",
                "to": "Page3"
            },
            {
                "from": "Page3",
                "to": "Page1"
            }
        ],
        "pages": [
            {
                "ns": 0,
                "title": "Page1",
                "missing": true
            }
        ]
    }
}

Zie ook

API:Main page - Snelstartgids
API:Raw query continue - Bevat informatie over het gebruik van de parameter rawcontinue.

Onderhouden door MediaWiki Interfaces Team.
Live chat (IRC): #mediawiki-core ^verbinden
Issue tracker: Phabricator MediaWiki-Action-API (Een bug melden)

FuzzyBot (talk | contribs)

Latest revision as of 01:44, 12 October 2025

API documentatie

action=query

Query modules

Voorbeelden

Voorbeeld 1: Pagina's specificeren

GET request

Response

Voorbeeld 2: Titel normaliseren

GET request

Response

Voorbeeld 3: Ontbrekende en ongeldige titels

GET request

Response

Voorbeeld 4: Vervolg queries

GET request

Response

GET request

Response

Voorbeeld 5: Batchcomplete

GET request

Response

Voorbeeld 6: Generatoren

GET request

Response

Vervolg queries

Mogelijke waarschuwingen

Parameter geschiedenis

Aanvullende opmerkingen

Doorverwijzingen oplossen

Zie ook