Wikimore

Category:MediaWiki action API/zh

action=query模組允许你取得有關維基和其中保存資料的資訊，例如特定頁面的維基文本，一組頁面的連結和分類，或是更改維基內容所需要的存取權杖。

以下文档是Special:ApiHelp/query的输出，由本网站（MediaWiki.org）运行的MediaWiki的预发行版本自动生成。

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]

查詢模組

查詢模組有三種子模块（也被稱為查詢模組）：

元信息（meta）：有关于维基和已登录用户的信息。
属性（properties）：页面的属性，包括页面修订版本和内容等。
列表（lists）：符合特定条件的页面。

範例1：指定頁面

与元数据和列表查询模块不同，所有属性查询模块都在一组页面上工作，这些页面可以通过以下方式之一进行指定：

按名称，使用参数 titles ，例如 titles=Foo|Bar|Main_Page。
按页面ID，使用参数pageids，例如pageids=123|456|75915。
按修订版本ID，使用 revids 参数，例如 revids=478198|54872|54894545。大多数查询模块会将修订ID转换为相应的页面ID。只有prop=revisions 实际上使用了修订ID本身。
使用一个发生器 Category:Gadget:TabbedWindow

GET请求

api.php?action=query&revids=347819|5487|548945&format=json&formatversion=2 [在Api沙盒中尝试]

回應

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

范例2：标题规范化

标题规范化将页面标题转换为规范形式。

这意味着将首字母大写，将下划线替换为空格，并将命名空间更改为该wiki定义的本地化形式。

页面标题中任何尾随的换行符（\n）会导致异常行为，应首先将其删除。

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&titles=Project:articleA|article_B&format=json&formatversion=2 [在Api沙盒中尝试]

回應

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

範例3：不存在和無效標題

不存在或无效的标题将在响应中设置missing或invalid属性。

在支持数字数组键的输出格式中，缺失和无效的标题将具有负页面ID。

在某些情况下，用户可以看到标题，但无法通过API访问，例如内容镜像自其他wiki的页面。

这些标题将在响应中设置 known 属性。

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&titles=Doesntexist|Main%20Page|Talk:&format=json&formatversion=2 [在Api沙盒中尝试]

回應

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

範例4：繼續查詢

当查询的响应中没有返回所有数据时，将会有一个 continue 属性来指示还有更多数据。

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2 [在Api沙盒中尝试]

回應

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

To get further data, add its values to the original request:

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&list=allcategories&acprefix=List%20of&formatversion=2&accontinue=List_of_largest_companies_in_Sri_Lanka&continue=-|| [在Api沙盒中尝试]

回應

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

示例 5：批处理

API返回一个batchcomplete元素，以指示已返回当前批次项目的所有数据。 MW 1.25+

在下面的示例查询响应中，已包含batchcomplete以表示已返回三张图片中的所有数据。

下一部分将继续为下一组3张图片返回数据。

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&list=allimages&ailimit=3&format=json&formatversion=2 [在Api沙盒中尝试]

回應

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

示例 6：生成器

使用生成器，若您希望获取一组页面的数据。

例如，要获取某个分类中页面的数据，可以使用generator=categorymembers将两个API调用合并为一个，以取代先查询list=categorymembers，再将pageids设置为对所有返回的页面进行查询的操作。

当使用列表模块作为生成器时，您不需要指定页码。

然而，对于一个属性模块，您应该指定生成器将工作的页面。

例如，要加载从主页链接的所有页面，请使用generator=links&titles=Main%20Page。

传递给生成器的参数必须以 g 为前缀。例如，当使用 generator=backlinks 时，应使用 gbllimit 而不是 bllimit。

下面的示例查询获取了主命名空间中以“Ba”开头的前三页的链接和分类。

Category:Gadget:TabbedWindow

GET请求

api.php?action=query&generator=allpages&gaplimit=3&gapfrom=Ba&prop=links|categories&format=json&formatversion=2 [在Api沙盒中尝试]

回應

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

继续查询

查询通常会显示比原始查询更多的结果。 (Often this is because a List query's result limit has been reached.) 在这些情况下，可以继续查询。关于继续查询的更详细信息可以在API:Continue 处找到。

可能的警告


警告訊息	原因
No support for special pages has been implemented.	如果给出Special:或Media:命名空间中的标题，则会抛出异常。这些命名空间中的页面无法查询。
重定向解决方案不能与`revids`参数一起使用。任何`revids`所指向的重定向都未被解决。	如果查询中使用了`redirect`参数，并且指定了使用`revids`的页面，则会抛出异常。

参数历史

v1.34: 启用exportschema
v1.24: 啟用rawcontinue (note: raw continuation was the default behavior until v1.26)
v1.21: 啟用continue

附加提醒

通过titles或pageids指定标题，每个查询限制为50个标题，对于有apihighlimits权限的人则限制为500个。
将多个查询模块一起使用，以在一次请求中获取所需内容，例如 prop=info|revisions&list=backlinks|embeddedin|allimages&meta=userinfo。
生成器总是将页面标题传递给查询模块。与列表（默认可能包含额外数据）不同，生成器本身不应输出任何信息，除非通过生成器模块的查询参数明确请求。

Resolving redirects

重定向可以自动解决，因此返回的是重定向的目标，而不是给定的标题。当存在时，它们将始终包含from和to属性，并且可能包含一个tofragment属性，用于指向特定章节的那些重定向。

规范化和重定向都可能发生。在存在多个重定向的情况下，所有重定向都将被解决，并且在存在循环重定向的情况下，“pages”部分可能没有页面（参见一个示例请求）。重定向解析不能与revids=参数或生成revids的生成器一起使用；这样做将产生一个警告，并且不会解析指定的revids的重定向。

下面的例子展示了redirects参数的工作方式。

使用“redirects”参数。 “Main page”是一个重定向到“Main Page”的链接

api.php?action=query&titles=Main%20page&redirects&format=json&formatversion=2 [在Api沙盒中尝试]

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

相同的请求，但没有“redirects”参数。

api.php?action=query&titles=Main%20page&format=json&formatversion=2 [在Api沙盒中尝试]

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

如果没有“redirects”，你可能想使用prop=info来获取重定向状态。

api.php?action=query&titles=Main%20page&prop=info&formatversion=2 [在Api沙盒中尝试]

结果

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

带有章节链接的请求。 “Wikipedia:!--”是一个重定向到“Wikipedia:Manual of Style#Invisible comments”的链接

api.php?action=query&titles=Wikipedia:!--&redirects&format=json&formatversion=2 [在Api沙盒中尝试]

结果

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

这是一个循环重定向的例子：Page1 → Page2 → Page3 → Page1。此外，在这个例子中使用了非规范化的名称 'page1'。

api.php?action=query&titles=page1&redirects&format=json&formatversion=2 [在Api沙盒中尝试]

结果

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

參見

API: - 快速上手指南
API:Raw query continue - 包含有关如何使用rawcontinue参数的信息。

Maintained by MediaWiki Interfaces Team.
Live chat (IRC): #mediawiki-core
Issue tracker: Phabricator MediaWiki-Action-API (Report an issue)

Wikimore

API:Query/zh

action=query

查詢模組

範例1：指定頁面

GET请求

回應

范例2：标题规范化

GET请求

回應

範例3：不存在和無效標題

GET请求

回應

範例4：繼續查詢

GET请求

回應

GET请求

回應

示例 5：批处理

GET请求

回應

示例 6：生成器

GET请求

回應

继续查询

可能的警告

参数历史

附加提醒

Resolving redirects

參見