API:Query/ru

Модуль  позволяет вам получать информацию о вики и хранящиеся в ней данные, такие как вики-текст конкретной страницы, ссылки и категории набора страниц, или токен, который вам нужен для.

Модули запросов
Модуль запросов имеет три типа подмодулей (также называемых модулями запросов):


 * о вики и вошедшем в систему пользователе.


 * страниц, включая версии страниц и их содержание.


 * страниц, соответствующих определенным критериям.

Пример 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:


 * По имени с помощью параметра, например.


 * По идентификатору страницы с помощью параметра, например.


 * По идентификатору версии с использованием параметра, например  . Большинство модулей запросов преобразуют идентификатор версии в соответствующий идентификатор страницы. Только  на самом деле использует сам идентификатор версии.


 * Используя генератор.

Пример 2: Нормализация заголовка
Нормализация заголовков преобразует заголовки страниц в их каноническую форму.

Это означает использование заглавных букв в первом символе, замена подчеркиваний пробелами и изменение пространства имен на локализованную форму, определенную для этой вики.

Пример 3: Отсутствующие и недопустимые заголовки
Заголовки, которые не существуют или являются недопустимыми, будут иметь в ответе соответствующий атрибут  или.

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

Пример 4: Продолжение запросов
Когда в ответ на запрос возвращаются не все данные, будет атрибут  указывающий на наличие дополнительных данных.

Чтобы получить дополнительные данные, добавьте его значения в исходный запрос.

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: Генераторы
Используйте генераторы, если вы хотите получить данные о наборе страниц.

Например, чтобы получить данные о страницах в определённой категории, вместо запроса, а затем повторного запроса с  , перечисляющим все возвращённые страницы, объедините два вызова API в один, используя.

При использовании модуля списка в качестве генератора вам не нужно указывать страницы.

Однако для модуля свойств вы должны указать страницы, на которых будет работать генератор.

Например, чтобы загрузить все страницы, связанные с главной страницей, используйте.

Параметры, передаваемые генератору, должны начинаться с. Например, при использовании, используйте   вместо.

Примера запроса ниже получает ссылки и категорий для первых трёх страниц в основном пространстве имен, начиная с "Ba".

История параметров

 * v1.26: Введены
 * v1.9: Введены

Дополнительная информация

 * 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 only pass page titles to the query module and do not output any information themselves. Setting parameters like  will therefore have no effect.

См. также

 * - The quick start guide.
 * - Contains information on how to use the  parameter.