Wikimore

Diese Seite ist Teil der Dokumentation der MediaWiki action API.

Mit dem action=query können Sie Informationen über ein Wiki und die darin gespeicherten Daten abrufen, z. B. den Wikitext einer bestimmten Seite, die Links und Kategorien einer Seitengruppe oder den Token, den Sie zum Ändern des Wiki-Inhalts benötigen.

API-Dokumentation

Die folgende Dokumentation ist die Ausgabe von Special:ApiHelp/query, die automatisch von der vorveröffentlichten MediaWiki-Version generiert wird, die auf dieser Seite (MediaWiki.org) läuft.

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 logged-in contributors and the count of logged-out 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
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.
globalgroups: Enumerate all global groups.
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.
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.
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 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, embeddedin, extdistrepos, exturlusage, filearchive, gadgetcategories, gadgets, globalallusers, globalblocks, globalgroups, imageusage, iwbacklinks, langbacklinks, linterrors, logevents, messagecollection, mostviewed, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, threads, 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.
oath: Internal. Check to see if two-factor authentication (OATH) is enabled for a 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, oath, 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.
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, 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]

Abfragemodule

Das Abfragemodul hat drei Typen von Submodulen (auch Abfragemodule genannt):

Meta-Informationen über das Wiki und angemeldete Benutzer.
Eigenschaften von Seiten, darunter Seitenversionen und Seiteninhalt.
Listen von Seiten, die bestimmte Kriterien erfüllen.

Beispiele

Beispiel 1: Seiten angeben

Im Gegensatz zu Meta- und Abfrage-Modulen funktionieren alle Eigenschaften-Abfragemodule auf einem Satz von Seiten, der auf eine der folgenden Wege festgelegt werden kann:

Nach Name mit dem titles-Parameter, z.B. titles=Foo|Bar|Main_Page.
Nach Seiten-ID mit dem pageids-Parameter, z.B. pageids=123|456|75915.
Nach Versions-ID mit dem revids-Parameter, z.B. revids=478198|54872|54894545. Die meisten Abfragemodule werden die Versions-ID in die entsprechende Seiten-ID umwandeln. Nur prop=revisions nutzt derzeit die Versions-ID selbst.
Mit einem Generator. Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&revids=347819|5487|548945&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

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

Beispiel 2: Titelnormalisierung

Titelnormalisierung wandelt Seitentitel in ihr kanonisches Format um.

Dies bedeutet, dass das erste Zeichen großgeschrieben wird, Unterstriche durch Leerzeichen ersetzt werden und Namensräume in die lokalisierte Form umgewandelt werden, die für das Wiki genutzt wird.

Alle Zeilenumbrüche in Seitentiteln (\n) werden seltsames Verhalten auslösen und sollten daher vorher entfernt werden.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&titles=Project:articleA|article_B&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

{
    "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
            }
        ]
    }
}

Beispiel 3: Fehlende und ungültige Titel

Titel, die nicht existieren oder ungültig sind, werden in der Antwort eines der Attribute missing oder invalid erhalten.

In Ausgabeformaten, die numerische Array-Schlüssel unterstützen, haben fehlende und ungültige Titel negative Seiten-IDs.

In manchen Fällen kann ein Titel von einen Benutzer, jedoch nicht von der API zugegriffen werden, wie Seiten, die den Inhalt eines anderen Wikis spiegeln.

Für diese Titel wird in der Antwort ein known-Attribut festgelegt.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&titles=Doesntexist|Main%20Page|Talk:&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

{
    "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"
            }
        ]
    }
}

Beispiel 4: Fortsetzen von Abfragen

Wenn in der Antwort der Abfrage nicht alle Daten ausgegeben werden, gibt es ein continue-Attribut, das angibt, dass es noch weitere Daten gibt.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

{
    "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"
            }
        ]
    }
}

Setze ihre Werte in die ursprüngliche Abfrage ein, um weitere Daten zu erhalten.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2&accontinue=List_of_largest_companies_in_Sri_Lanka&continue=-|| [In der ApiSandbox ausprobieren]

Antwort

{
    "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"
            }
        ]
    }
}

Beispiel 5: Batchcomplete

Die API gibt ein batchcomplete-Element aus, um anzuzeigen, dass alle Daten für den aktuellen Stapel von Objekten ausgegeben wurden. MW 1.25+

In die Antwort der Beispiel-Abfrage unten wurde batchcomplete eingebunden, um anzuzeigen, dass alle Daten für jedes der drei Bilder ausgegeben wurden.

Die nächste Fortsetzung wird mit der Ausgabe der Daten für den nächsten Satz von drei Bildern beginnen.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&list=allimages&ailimit=3&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

{
  "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"
      }
    ]
  }
}

Beispiel 6: Generatoren

Nutze Generatoren, wenn du Daten über einen Satz von Seiten erhalten möchtest.

Um beispielsweise Daten über Seiten in einer bestimmten Kategorie zu erhalten, frage nicht zuerst list=categorymembers ab und dann nochmal mit pageids bei allen ausgegebenen Seiten, sondern kombiniere die beiden API-Abfragen mithilfe von generator=categorymembers.

Wenn du ein Listenmodul als Generator nutzt, musst du die Seiten nicht angeben.

Für ein Eigenschaftsmodul solltest du hingegen die Seiten angeben, die der Generator bearbeiten soll.

Nutze zum Beispiel generator=links&titles=Main%20Page, um alle Seiten zu laden, die von der Hauptseite verlinkt sind.

Parameter, die an einen Generator übergeben werden, müssen mit einem Präfix g versehen werden. Nutze bei generator=backlinks beispielsweise gbllimit statt bllimit.

Die einfache Abfrage unten fragt Links und Kategorien für die ersten drei Seiten im Hauptnamensraum, die mit "Ba" beginnen ab.

Category:Gadget:TabbedWindow

GET-Anfrage

api.php?action=query&generator=allpages&gaplimit=3&gapfrom=Ba&prop=links|categories&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Antwort

{
     "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"
             }
         ]
     }
}

Abfragen fortsetzen

Abfragen enthalten oft mehr Ergebnisse als in der ursprünglichen Abfrage angezeigt werden. (Often this is because a List query's result limit has been reached.) In diesen Fällen können die Abfragen fortgesetzt werden. Ausführlichere Informationen zur Fortsetzung von Abfragen befinden sich unter API:Continue .

Mögliche Warnungen


Warnmeldung	Ursache
Es wurde keine Unterstützung für Spezialseiten implementiert.	Wird ausgegeben, wenn ein Titel im Spezial- oder Media-Namensraum gegeben ist. Die Seiten in diesen Namensräumen können nicht abgefragt werden.
Redirect resolution cannot be used together with the `revids` parameter. Any redirects the `revids` point to have not been resolved.	Wird ausgegeben, wenn der `redirect`-Parameter in einer Abfrage genutzt wird, die Seiten mit `revids` angibt.

Parametergeschichte

v1.34: exportschema eingeführt
v1.24: Eingeführt rawcontinue (Anmerkung: raw continuation war das Standardverhalten bis v1.26)
v1.21: Eingeführt continue

Zusätzliche Anmerkungen

Die Angabe der Titel über titles oder pageids ist auf 50 Titel je Abfrage oder 500 für Benutzer mit dem Recht apihighlimits begrenzt.
Nutze mehrere Abfragemodule zusammen, um in einer Abfrage zu erhalten, was du benötigst, z.B. prop=info|revisions&list=backlinks|embeddedin|allimages&meta=userinfo.
Generatoren übergeben immer Seitentitel an das Abfragemodul. Anders als Listen (die standardmäßig zusätzliche Daten enthalten können), sollten Generatoren selbst keine Informationen ausgeben, es sei denn, sie werden ausdrücklich über die Abfrageparameter des Generatormoduls angefordert.

Weiterleitungen auflösen

Weiterleitungen können automatisch aufgelöst werden, sodass das Ziel einer Weiterleitung statt des gegebenen Titels ausgegeben wird. Wenn vorhanden, werden sie immer die Attribute from und to enthalten und können für Weiterleitungen, die auf bestimmte Abschnitte verweisen, das Attribut tofragment enthalten.

Sowohl Normalisierung als auch Weiterleitung können stattfinden. Im Fall mehrfacher Weiterleitungen werden alle Weiterleitungen aufgelöst und im Falle einer Weiterleitung im Kreis gibt es möglicherweise keine Seite im Abschnitt 'pages' (siehe auch unten). Die Auflösung von Weiterleitungen kann nicht zusammen mit dem Parameter revids= oder einem Generator, der Versions-IDs generiert, genutzt werden; dies zu tun wird eine Warnung auslösen und Weiterleitungen für die angegebenen Versions-IDs werden nicht aufgelöst.

Die Beispiele unten zeigen, wie der Parameter redirects funktioniert.

Nutzung des Parameters "redirects". "Main page" ist eine Weiterleitung auf "Main Page"

api.php?action=query&titles=Main%20page&redirects&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

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

Die gleiche Abfrage ohne den Parameter "redirects".

api.php?action=query&titles=Main%20page&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

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

Ohne "redirects" möchtest du vielleicht prop=info nutzen, um den Weiterleitungs-Status zu erhalten.

api.php?action=query&titles=Main%20page&prop=info&formatversion=2 [In der ApiSandbox ausprobieren]

Ergebnis

{
    "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
            }
        ]
    }
}

Abfrage mit einem Abschnittslink. "Wikipedia:!--" ist eine Weiterleitung auf "Wikipedia:Manual of Style#Invisible comments"

api.php?action=query&titles=Wikipedia:!--&redirects&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Ergebnis

{
    "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 ist ein Fall einer Weiterleitung im Kreis: Page1 → Page2 → Page3 → Page1. Außerdem wird in diesem Beispiel ein nicht normalisierter Name 'page1' genutzt.

api.php?action=query&titles=page1&redirects&format=json&formatversion=2 [In der ApiSandbox ausprobieren]

Ergebnis

{
    "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
            }
        ]
    }
}

Siehe auch

API:Hauptseite - Die Schnellstart-Anleitung.
API:Raw query continue - Enthält Informationen zur Nutzung des Parameters rawcontinue.

Gewartet von MediaWiki Interfaces Team.
Echtzeit-Chat (IRC): #mediawiki-core ^connect
Problem-Tracker: Phabricator MediaWiki-Action-API (Problem melden)

Wikimore

API:Query/de

API-Dokumentation

action=query

Abfragemodule

Beispiele

Beispiel 1: Seiten angeben

GET-Anfrage

Antwort

Beispiel 2: Titelnormalisierung

GET-Anfrage

Antwort

Beispiel 3: Fehlende und ungültige Titel

GET-Anfrage

Antwort

Beispiel 4: Fortsetzen von Abfragen

GET-Anfrage

Antwort

GET-Anfrage

Antwort

Beispiel 5: Batchcomplete

GET-Anfrage

Antwort

Beispiel 6: Generatoren

GET-Anfrage

Antwort

Abfragen fortsetzen

Mögliche Warnungen

Parametergeschichte

Zusätzliche Anmerkungen

Weiterleitungen auflösen

Siehe auch