API:Query/zh

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



-{zh-hans:API帮助文档; zh-hant:API說明文件}-


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


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

-{zh-hans:示例; zh-hant:範例;}-


範例1：指定頁面
Unlike meta and list query modules, all property query modules work on a set of pages that can be specified in one of the following ways:

Most query modules will convert revision ID to the corresponding page ID. Only actually uses the revision ID itself.
 * By name using the  parameter, e.g..
 * By page ID using the  parameter, e.g..
 * By revision ID using the  parameter, e.g..
 * Using a generator.



回應


範例2：標題正規化
Title normalization converts page titles to their canonical form.

This means capitalizing the first character, replacing underscores with spaces, and changing namespace to the localized form defined for that wiki.



回應


範例3：不存在和無效標題
Titles that don't exist or are invalid will have a  or   attribute set in the response.

In output formats that support numeric array keys, missing and invalid titles will have negative page IDs.

In some cases, a title can be viewed by a user but cannot be accessed by the API, such as pages that mirror content from another wiki. These titles will have a  attribute set in the response.



回應


範例4：繼續查詢
When all the data is not returned in the response of a query, there will be a  attribute to indicate that there is more data.



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

Example 5: Batchcomplete
The API returns a  element to indicate that all data for the current batch of items has been returned.

In the response of the sample query below,  has been included to indicate that all the data for each of the three images has been returned.

The next continuation will begin returning data for the next set of 3 images.



Example 6: Generators
Use generators if you want to get data about a set of pages.

For example, to get data about pages in a certain category, instead of querying  and then querying again with   set to all the returned pages, combine the two API calls into one by using.

When using a list module as a generator, you don't need to specify the pages.

However, for a property module, you should specify the pages which the generator will work on.

For example, to load all pages that are linked to from the main page, use.

Parameters passed to a generator must be prefixed with a. For instance, when using, use   instead of.

The sample query below gets links and categories for the first three pages in the main namespace starting with "Ba".



Continuing queries
Queries will often have more results available than are just shown in the original query. (Often this is because a List query's result limit has been reached.) In these cases, queries can be continued. More detailed information on continuing queries can be at API:Continue.



可能的警告


参数历史

 * v1.34: Introduced
 * v1.24: 啟用 (note: raw continuation was the default behavior until v1.26)
 * v1.21: 啟用



附加提醒

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * Use multiple query modules together to get what you need in one request, e.g..
 * Generators always pass page titles to the query module. Unlike lists (which may include additional data by default), generators should not output any information themselves, unless when explicitly requested via the generator module's query parameters.

Resolving redirects
Redirects can be resolved automatically, so that the target of a redirect is returned instead of the given title. When present, they will always contain  and   attributes and may contain a   attribute for those redirects that point to specific sections.

Both normalization and redirection may take place. In the case of multiple redirects, all redirects will be resolved, and in case of a circular redirect, there might not be a page in the 'pages' section (see also below). Redirect resolution cannot be used in combination with the  parameter or with a generator generating revids; doing that will produce a warning and will not resolve redirects for the specified revids.

The examples below show how the  parameter works.



參見

 * - 快速上手指南
 * - 包含有关如何使用 参数的信息.