API:Query/ja

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

クエリ モジュール群
クエリ モジュールには 3 件の下位モジュールがあります (クエリ モジュールとも呼ぶ):


 * ウィキとログイン利用者に関する.
 * ページの版や内容を含む (属性).
 * 特定の基準に適合するページの.

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


 * ページ名を指定するには パラメータを使う. 例＝.
 * ページ ID の指定には パラメータを使う. 例＝.
 * 更新 ID の指定には パラメータを使う. 例＝ . 大部分のクエリモジュールでは更新 ID を対応するページ ID に変換します.  実際に更新 ID そのものを使うのは、のみです.
 * ジェネレータを使用.

例2: タイトルの平準化
タイトルの平準化により、ページ名を基準系に従って変換します.

簡単に言うと1文字目を大文字に、アンダーバー「 _ 」「半角スペースに、またそのウィキに適したページ名に地域化することです.

例3: ページ名がない、あるいは無効
存在しないもしくは無効なページ名は、 または 属性を付けて返してきます.

数字の並びキーをサポートする出力フォーマットでは、存在しないもしくは無効なページ名には、マイナスのページIDを与えます.

例4: 継続型のクエリ
もしクエリに対して返した分以外にもデータがある場合には 属性が付いており、追加のデータがあると示します.

残りのデータを取得するには、元のリクエストにその値を追加します.

例5: Batchcomplete
API は 要素を返し、現在の項目群に対するデータは全て返したと示します.

以下のクエリに対して をくわえてあるのは、画像3点全てにデータを返したと示しています.

次の継続クエリは、次の画像3点を対象にデータを返します.

例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.21:  を導入しました
 * v1.24:  を導入しました (note raw continuation was the default behavior until v1.26)

追加的な注記

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * * 単一のリクエストで期待する結果を得るには、例えば のように、複数のクエリを組み合わせます.
 * 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.

関連項目

 * - クイック スタート ガイド.
 * - パラメーター の使い方の情報を掲載.