API:Query/zh

action=query模块允许您检索各种类型的数据，它不严格地基于现在已经过时的模块Query API. action=query也被用于检查编辑等操作所需的权限.

action=query模块由许多子模块（称为查询模块）构成，每个查询模块都具有不同的功能. 下面是三个查询模块：
 * 元信息模块 关于维基和已登录用户的信息.
 * 属性模块 关于页面的属性，包括页面修订版本和内容等.
 * 列表模块 列出符合特定条件的页面.

查询模块可以自由联合. 因此，您可以用如下方式在一个请求中同时调用6个查询模块：

除了通过各种查询模块实现功能，action=query模块也有一些自有的功能.

查询示例
在正式开始之前，我们先来看一个获取页面信息的简单示例：

api.php?action=query&prop=revisions&rvprop=content&format=xml&titles=Main%20Page

它的意思是查询（“action=query”）wiki主页（"title=Main%20Page"）的最新修订（"prop=revisions"）的内容（"rvprop=content"），并以XML格式返回（"format=xml"）.

另外，您也可以用action=raw作为index.php的参数，用以获取页面的内容： index.php?title=Main%20Page&action=raw

指定标题
您可以用以下方式指定页面标题：
 * 使用 参数，例如：
 * 使用 参数，例如：
 * 使用 参数，例如：
 * 注：使用 参数时，多数的模块会使用这个修订版本ID所属的页面. 只有prop=revisions模块使用这个修订版本本身.
 * 使用一个生成器

标题标准化
标题标准化将页面标题转换为规范格式. 包括将首字母转为大写，将下划线替换为空格等等. 无论使用什么查询模块，标题标准化都是自动完成的. 但是，页面标题中的所有行末换行符（\n）都会导致模块的异常行为，所以必须先将他们去除.

不存在的和无效的标题
不存在的和无效的标题仍然在 段中列出，但是它们具有 或者 的属性. 在支持数字形式的数组索引的输出格式（比如JSON或者序列化PHP）中，不存在的和无效的标题会有一个独有的负数页面ID. 查询模块会直接忽略不存在的和无效的标题，因为无法对它们做出任何有意义的操作.

在Special:和Media:命名空间中的标题
目前，在Special:和Media:命名空间下的标题不能被查询. 如果一个这样的标题出现在 中或者被生成器交送给某个模块，将会生成一个警告.

处理重定向
页面重定向可以被自动处理，因而重定向之后的标题将会代替给定的标题返回. 下面的例子不太有实用价值，因为它没有使用任何查询模块，但是它显示了 参数是如何工作的. 标题标准化和重定向都会被执行. 如果有二次重定向，每次重定向都会被执行. 如果出现了循环重定向，'pages'节点下面可能不会列出任何页面（参见循环重定向）. 重定向参数不能和 参数或者生成revid的生成器一起使用，否则会产生一个警告，并且不会执行对特定revid的重定向.

循环重定向
假设有Page1 &rarr; Page2 &rarr; Page3 &rarr; Page1 (产生了循环重定向). 另外本例中使用了一个非标准化的标题'page1'.

数目限制
关于数目限制的详细内容请参见这里.

后续检索
很多时候，您可能无法再一次请求中获得所有返回结果. 这时您可以提供一个 值来继续检索.

此时，您可以使用 来获得下面的10个分类.

当使用一个生成器时，您可能会获得两个 值，一个是用于生成器的，另一个是用于“正常模式”的. 在这种情况下，你需要首先执行“正常模式”的后续查询，直到它完成后，才可以继续使用生成器查询. 您不应该将这两个 参数同时设置.

获取页面ID的列表
利用 参数，你可以获得一个页面ID组成的列表，它被包括在 元素中. 这点对于那些使用数字来做数组索引的数据格式（比如JSON）尤其有用.

导出页面
您可以使用 参数从API中导出页面. 如果设置了 参数，所有 中的页面的内容将会以XML的形式包含在返回结果中. 参数只有在指定标题时才有效（使用生成器，titles，pageids或者revids）. 请注意导出的XML会按请求中要求的格式给出；如果要求的格式是XML，&lt;与&gt;之类的字符会被转义成&amp;lt;与&amp;gt;的形式. 如果也设置了 参数，则只有相应的导出XML（未被包裹在API结果里）被返回.

参见导入页面

生成器
使用生成器，您可以使用一个列表的输出来代替查询中的 参数. 这个列表的输出必须是一组页面. 这组页面的标题已经自动代替了 、 或者 参数. 其他查询模块将会把生成器如同 参数一样处理. 一次查询中只允许一个生成器. 如果列表模块返回的并非页面列表，那么它就不能用作生成器. 某些属性模块可以被当作生成器使用.

提交给生成器的参数必须以字母 开头. 例如，使用 时，要用 代替.

另外需要注意的是生成器只能传递“真实”的查询的页面标题，而不能给出关于生成器自己的任何信息. 比如， 这样的参数并不能产生任何效果.

生成器与重定向
在这里我们使用prop=links作为生成器. 这个查询会在所有页面中查找所有符合标题“Title”的链接. 此例中，假设页面Title具有指向TitleA和TitleB的链接，TitleB是对于TitleC的一个重定向，TitleA链接到TitleA1，TitleA2和TitleA3，而TitleC链接到TitleC1和TitleC2. 因为设置了 参数，重定向被自动执行了.

查询将会按照一下的步骤执行：
 * 1) 执行 中所规定的标题的重定向
 * 2) 对于所有在 中的标题，获取相应的标题列表
 * 3) 在标题列表中执行页面重定向
 * 4) 对重定向后的标题列表执行prop=links的查询

更多生成器示例

 * 显示以“T”开头的4个页面的信息：
 * http://en.wikipedia.org/w/api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info


 * 显示以“Re”开头的前两个非重定向页面的信息：
 * http://en.wikipedia.org/w/api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content

可能的警告

 * No support for special pages has been implemented.（不支持特殊页面. ）
 * 当请求包含在Special:或Media:命名空间中的主题时产生.
 * Redirect resolution cannot be used together with the revids= parameter. Any redirects the revids= point to have not been resolved.（重定向不能与revids=参数一起使用. ）
 * 注意，此警告也可能是由一个生成revids的生成器导致的.