API:Query - Properties/ru
This page is part of the MediaWiki Action API documentation. |
Свойства используются для получения различных данных о списке страниц, определённых либо с помощью параметров titles=, pageids=, revids=, либо с помощью генераторов.
info / in
editВерсия MediaWiki: | 1.9 |
Получение основной информации о странице
Параметры
editinprop
: Какие свойства получитьprotection
: Уровень защитыtalkid
: ID страницы обсуждения для каждой страницы не-обсужденияsubjectid
: ID родительской страницы для каждой страницы обсуждения- По умолчанию, будут перечислены следующие свойства:
- ID страницы (
pageid
) - пространство имен (
ns
) - заголовок (
title
) - метка времени последнего изменения (
touched
) - ID последней ревизии (
lastrevid
) - число просмотров (
counter
) - размер станицы (
length
) - является ли страница перенаправлением (
redirect
) - есть ли у страницы только одна ревизия (
new
)
- ID страницы (
intoken
: Получения токена для модификации страницы
Пример
editResult |
---|
<?xml version="1.0" encoding="utf-8"?>
<api>
<query>
<pages>
<page
pageid="736" ns="0" title="Albert Einstein"
touched="2008-03-27T04:42:56Z" lastrevid="201248286"
counter="4698" length="81826" talkid="2177">
<protection>
<pr type="edit" level="autoconfirmed" expiry="infinity" />
<pr type="move" level="sysop" expiry="infinity" />
</protection>
</page>
</pages>
</query>
</api>
|
Возможные предупреждения
edit- Action 'action' is not allowed for the current user
- Вызывается, если запрашивается токен для пользователя, не имеющего на это прав
Возможные ошибки
editНет
revisions / rv
editВерсия MediaWiki: | 1.8 |
Возвращает ревизии для заданной страницы или последние ревизии для нескольких старниц. При ипользовании параметров, отмеченных как (enum), titles=
должон быть указано только одно название.
Параметры
editrvprop
: Какие свойства получать для каждой ревизииids
: ID ревизии (по умолчанию) ПРИМЕЧАНИЕ: Реализовано только в версиях MediaWiki 1.11 и выше.flags
: Является ли ревизия малой правкой (по умолчанию)timestamp
: Дата и время выполнения правки (по умолчанию)user
: Пользователь, сделавший правку (по умолчанию)comment
: Комментарий правки (по умолчанию)size
: Размер текста ревизии в байтахcontent
: Содержание ревизии. Если выбран этот параметр, будет установлено ограничение в 10 страниц как минимум
rvlimit
: Максимальное число возвращаемых ревизий (enum)rvstartid
: ID ревизии, с которой начать список. (enum)rvendid
: ID ревизии, на которой закончить список. (enum)rvstart
: Метка времени, с которой начинать список. (enum)rvend
: Метка времени, на которой закончить список. (enum)rvdir
: Направление списка. (enum)older
: Выводить новейшие ревизии сначала (по умолчанию). ПРИМЕЧАНИЕ: rvstart/rvstartid должно быть выше, чем rvend/rvendidnewer
: Выводить старейшие ревизии сначала. ПРИМЕЧАНИЕ: rvstart/rvstartid должно быть ниже, чем rvend/rvendid
rvuser
: Выводить только ревизии, сделанные этим пользователемrvexcludeuser
: Не выводить ревизии, сделанные этим пользователемrvexpandtemplates
: Развёртывать шаблоны в выводеrvprop=content
rvsection
: Если установлен параметрrvprop=content
, получать только содержимое этого раздела. ПРИМЕЧАНИЕ: Реализовано только в версиях MediaWiki 1.13 и выше.rvtoken
: Токены для каждой ревизииrollback
: Токен отката
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="1191" ns="0" title="API">
<revisions>
<rev user="Harryboyles" timestamp="2006-10-31T05:39:01Z" comment="revert unexplained change: see talk ...">
...content...
</rev>
</revisions>
</page>
<page pageid="11105676" ns="0" title="Main Page">
<revisions>
<rev user="Ryan Postlethwaite" timestamp="2007-06-26T19:05:06Z" comment="rv - what was that for?">
...content...
</rev>
</revisions>
</page>
</pages>
</query>
</api>
|
Возможные предупреждения
edit- Action 'action' is not allowed for the current user
- Вызывается, если запрашивается токен для пользователя, не имеющего на это прав
Возможные ошибки
edit- код: rvrevids
- информация: Параметр revids= не может быть использован с опциями списка (limit, startid, endid, dirNewer, start, end).
- код: rvmultpages
- информация: Были использованы titles, pageids или generator для работы с несколькими страницами, но параметры limit, startid, endid, dirNewer, user, excludeuser, start и end могут быть использованы только для одной страницы.
- код: rvaccessdenied
- информация: Текущий пользователь не может прочитать title
- код: rvbadparams
- информация: start и startid не могут быть использованы вместе
- код: rvbadparams
- info: end и endid cannot не могут быть использованы вместе
- код: rvbadparams
- информация: user и excludeuser не могут быть использованы вместе
- код: rvnosuchsection
- информация: Нет секции section в revid
categories / cl
editВерсия MediaWiki: | 1.11 |
Получает список всех категорий, используемых на заданных страницах. Этот модуль может быть использован в качестве генератора.
Параметры
editclprop
: Какие свойства получить (не быть использован с генератором)sortkey
: Ключ сортировкиtimestamp
: Дата и время добавления страницы в категорию, либо дата и время последнего изменения ключа сортировки.
clshow
: Какие типы категорий перечислять. Конфликтующие опции (такие какhidden
и!hidden
) не могут быть использованы вместе.hidden
: Только перечислять скрытые категории!hidden
: Не перечислять скрытые категории
cllimit
: Максимальное число результатов для возвратаclcontinue
: При доступности боáльшего числа результатов, использовать это для продолженияclcategories
: Только перечислять эти категории. Полезно для проверки, принадлежит ли определённая страница определённой категории- Этот параметр принимает только полные названия, поэтому должен использоваться префикс Category:
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<categories>
<cl ns="14" title="Category:1879 births" />
<cl ns="14" title="Category:1955 deaths" />
<cl ns="14" title="Category:Albert Einstein" />
...
</categories>
</page>
</pages>
</query>
</api>
|
Возможные предупреждения
edit- ``title'' is not a category
- Указанного названия нет в пространстве имён Category:
Возможные ошибки
edit- code: clshow
- info: Некорректный параметр - взаимно исключающие значения не могут использоваться
imageinfo / ii
editВерсия MediaWiki: | 1.11 |
Получает информацию о файлах в пространстве имён изображений
Параметры
editiiprop
: Какие свойства получитьtimestamp
: Время и дата ревизии (по умолчанию)user
: Пользователь, создавший ревизию (по умолчанию)comment
: Комментарий правкиurl
: URL изображенияsize
: Размер изображения в байтах, ширина и высотаsha1
: Хеш SHA-1 изображенияmime
: Тип MIME изображенияmetadata
: Метаданные изображения, если присутствуютarchivename
: Имя архива (только для старых изображений)
iilimit
: Число возвращаемых ревизий изображения (1 по умолчанию)iistart
: Метка времени, с которой начинать перечислениеiiend
: Метка времени, на которой закончить перечислениеiiurlwidth
: Если установлен параметрiiprop=url
, будет возвращён также URL изображения, масштабированного до заданной длины. Старые версии изображений не могут быть масштабированыiiurlheight
: Схожее действие сiiurlwidth
Example
editResult |
---|
<?xml version="1.0" encoding="utf-8"?>
<api>
<query>
<pages>
<page ns="6" title="Image:Albert Einstein Head.jpg" missing="" imagerepository="shared">
<imageinfo>
<ii timestamp="2007-10-20T02:29:04Z" user="Rocket000" />
</imageinfo>
</page>
</pages>
</query>
<query-continue>
<imageinfo iistart="20071020022358" />
</query-continue>
</api>
|
langlinks / ll
editВерсия MediaWiki: | 1.9 |
Получает список всех языковых ссылок с указанных страниц на другие языки.
Возвращаются только языковые ссылки для 50 названий
Параметры
edit- llimit - количество возвращаемых значений. по умолчанию 10. Не должно превышать 500 (5000 для ботов)
- llcontinue - есть еще результаты, используется для продолжения
Пример
editResult |
---|
<?xml version="1.0" encoding="utf-8"?>
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<langlinks>
<ll lang="af">Albert Einstein</ll>
<ll lang="als">Albert Einstein</ll>
<ll lang="an">Albert Einstein</ll>
<ll lang="ar">ألبرت أينشتاين</ll>
<ll lang="ast">Albert Einstein</ll>
<ll lang="az">Albert Eynşteyn</ll>
...
</langlinks>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет
links / pl
editВерсия MediaWiki: | 1.9 |
Получает список всех ссылок на указанных страницах. Этот модуль может быть использован в качестве генератора.
Параметры
editplnamespace
: Перечислять только ссылки на эти пространства имёнpllimit
: Сколько ссылок возвращать. По умолчанию 10. Разрешено не более 500 (5000 для ботов).plcontinue
: Если ещё доступны результаты, используйте этот параметр для продолжения
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<links>
<pl ns="0" title="1879" />
<pl ns="0" title="1901" />
...
<pl ns="0" title="Albert Einstein: The Practical Bohemian" />
<pl ns="0" title="Albert Einstein Archives" />
<pl ns="0" title="Albert Einstein Award" />
<pl ns="0" title="Albert Einstein Foundation for Higher Learning, Inc." />
<pl ns="0" title="Albert Einstein Memorial" />
<pl ns="0" title="Albert Einstein Peace Prize" />
...
<pl ns="0" title="Zurich" />
<pl ns="4" title="Wikipedia:Citing sources" />
<pl ns="4" title="Wikipedia:Media help" />
<pl ns="4" title="Wikipedia:Persondata" />
<pl ns="4" title="Wikipedia:Protection policy" />
<pl ns="4" title="Wikipedia:Sister projects" />
<pl ns="6" title="Image:Albert Einstein german.ogg" />
<pl ns="10" title="Template:Nobel Prize in Physics" />
...
<pl ns="10" title="Template:Nobel Prize in Physics Laureates 2001-2025" />
<pl ns="11" title="Template talk:Nobel Prize in Physics Laureates 1901-1925" />
</links>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет
templates / tl
editВерсия MediaWiki: | 1.9 |
Получает список всех страниц, включённых в заданные страницы. Этот модуль может быть использован в качестве генератора.
Параметры
edittlnamespace
: Перечислять только страницы в этом пространстве имёнtllimit
: Сколько шаблонов возвращать
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<templates>
<tl ns="10" title="Template:Academia" />
<tl ns="10" title="Template:Age at date" />
<tl ns="10" title="Template:Audio" />
<tl ns="10" title="Template:Birth date" />
...
</templates>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет.
images / im
editВерсия MediaWiki: | 1.9 |
Получает список всех изображений, используемых на заданных страницах. Этот модуль может быть использован в качестве генератора.
Параметры
editНет.
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<images>
<im ns="6" title="Image:1919 eclipse positive.jpg" />
<im ns="6" title="Image:Albert Einstein Head.jpg" />
<im ns="6" title="Image:Albert Einstein german.ogg" />
<im ns="6" title="Image:Albert Einstein photo 1921.jpg" />
...
</images>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет.
extlinks / el
editВерсия MediaWiki: | 1.11 |
Получение списка всех внешних ссылок на заданных страницах
Параметры
editНет.
Пример
editResult |
---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<extlinks>
<el>http://albert-einstein.org/</el>
<el>http://albert-einstein.org/history5.html</el>
<el>http://ame.epfl.ch/biblio/schlatter1.pdf</el>
...
</extlinks>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет.
categoryinfo / ci
editВерсия MediaWiki: | 1.13 |
Получает информацию о категориях
- Примечание
- Если страница категории существует, но у категории нет членов, поле «categoryinfo» не будет включено в ответ API.
Параметры
editНет
Пример
editResult |
---|
<?xml version="1.0" encoding="utf-8"?>
<api>
<query>
<normalized>
<n from="Category:Templates_using_ParserFunctions" to="Category:Templates using ParserFunctions" />
</normalized>
<pages>
<page ns="14" title="Category:Foo" missing="" />
<page ns="14" title="Category:Templates using ParserFunctions" missing="">
<categoryinfo size="8" pages="8" files="0" subcats="0" />
</page>
<page pageid="736" ns="0" title="Albert Einstein" />
<page pageid="37" ns="14" title="Category:Infobox">
<categoryinfo size="0" pages="1" files="-1" subcats="0" />
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет
duplicatefiles / df
editВерсия MediaWiki: | 1.14 |
Список дубликатов заданных файлов.
Параметры
editdflimit
: Сколько дубликатов перечислятьdfcontinue
: Если ещё доступны результаты, используйте этот параметр для продолжения
Пример
editResult |
---|
<?xml version="1.0"?>
<api>
<query>
<pages>
<page pageid="99" ns="6" title="Image:Bombers.ogg">
<duplicatefiles>
<df name="Bombers2.ogg" user="Catrope" timestamp="2008-09-27T11:12:45Z" />
</duplicatefiles>
</page>
<page pageid="41" ns="6" title="Image:Welcome.gif">
<duplicatefiles>
<df name="Welcome2.gif" user="Catrope" timestamp="2008-09-27T11:30:30Z" />
</duplicatefiles>
</page>
</pages>
</query>
</api>
|
Возможные ошибки
editНет.