API:Query/ja

モジュールを使い、特定のウィキとそこに収載されたデータのから情報を取得します. 指定したページのウィキテキスト、複数ページのリンクやカテゴリ、またため必要なトークンを得ることができます.

クエリ モジュール群
クエリモジュールには3件のサブモジュールがあります (クエリモジュールとも呼ぶ).
 * ウィキとログイン利用者に関する.
 * ページの版や内容を含む (属性).
 * 特定の基準に適合するページの.

例1: ページの指定
メタやリストクエリと比べると、プロパティクエリ モジュールは全て複数のページを処理でき、以下のいずれかの方法で対象ページを指定します.


 * パラメータを使い、ページ名で指定. 例＝.
 * ページ ID の指定には パラメータを使う. 例＝.
 * By revision ID using the  parameter, e.g.  . Most query modules will convert revision ID to the corresponding page ID. Only  actually uses the revision ID itself.
 * Using a generator.

Example 2: Title normalization
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.

Example 3: Missing and invalid titles
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.

Example 4: Continuing queries
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.

例6: ジェネレータ
複数ページからデータを得るには、ジェネレータを使います. 例えば特定のカテゴリ内の複数ページからデータを得るには、クエリ を実行してからその結果のページにもう一度、クエリ をかけるのではなく、 を使い2件のAPIを組み合わせます.

一覧モジュールをジェネレータとして使う場合は、対象ページの指定は不要です. ただし属性のモジュールには ジェネレーターの作業対象の ページを指定する必要があります. 例えばメインページのリンク先のページを読み込むには、 を使用します.

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".

パラメーターの履歴

 * v1.26:  を導入しました
 * v1.9:  を導入しました

追加的な注記

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * 単一のリクエストで期待する結果を得るには、例えば のように、複数のクエリを組み合わせます.
 * Generators only pass page titles to the query module and do not output any information themselves. Setting parameters like  will therefore have no effect.

関連項目

 * - クイック スタート ガイド.
 * - Contains information on how to use the  parameter.