API:Query - Properties/ru

Свойства используются для получения различных данных о списке страниц, определённых либо с помощью параметров titles=, pageids=, revids=, либо с помощью генераторов.

info / in

Версия MediaWiki:

1.9

Получение основной информации о странице

Параметры

• inprop: Какие свойства получить
  • protection: Уровень защиты
  • talkid: ID страницы обсуждения для каждой страницы не-обсуждения
  • subjectid: ID родительской страницы для каждой страницы обсуждения
  • По умолчанию, будут перечислены следующие свойства:
    • ID страницы (pageid)
    • пространство имен (ns)
    • заголовок (title)
    • метка времени последнего изменения (touched)
    • ID последней ревизии (lastrevid)
    • число просмотров (counter)
    • размер станицы (length)
    • является ли страница перенаправлением (redirect)
    • есть ли у страницы только одна ревизия (new)
• intoken: Получения токена для модификации страницы

Пример

Получение информации о странице en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=info&inprop=protection|talkid [try in ApiSandbox]

Result
<?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>

Возможные предупреждения

• Action 'action' is not allowed for the current user
  • Вызывается, если запрашивается токен для пользователя, не имеющего на это прав

Возможные ошибки

Нет

revisions / rv

Версия MediaWiki:

1.8

Возвращает ревизии для заданной страницы или последние ревизии для нескольких старниц. При ипользовании параметров, отмеченных как (enum), titles= должон быть указано только одно название.

Параметры

• rvprop: Какие свойства получать для каждой ревизии
  • 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/rvendid
  • newer: Выводить старейшие ревизии сначала. ПРИМЕЧАНИЕ: rvstart/rvstartid должно быть ниже, чем rvend/rvendid
• rvuser: Выводить только ревизии, сделанные этим пользователем
• rvexcludeuser: Не выводить ревизии, сделанные этим пользователем
• rvexpandtemplates: Развёртывать шаблоны в выводе rvprop=content
• rvsection: Если установлен параметр rvprop=content, получать только содержимое этого раздела. ПРИМЕЧАНИЕ: Реализовано только в версиях MediaWiki 1.13 и выше.
• rvtoken: Токены для каждой ревизии
  • rollback: Токен отката

Пример

Получить данные, включающие содержание последней ревизии страниц en:API и en:Main Page

api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content [try in ApiSandbox]

Result

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

Возможные предупреждения

• Action 'action' is not allowed for the current user
  • Вызывается, если запрашивается токен для пользователя, не имеющего на это прав

Возможные ошибки

• код: 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

Версия MediaWiki:

1.11

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

Параметры

• clprop: Какие свойства получить (не быть использован с генератором)
  • sortkey: Ключ сортировки
  • timestamp: Дата и время добавления страницы в категорию, либо дата и время последнего изменения ключа сортировки.
• clshow: Какие типы категорий перечислять. Конфликтующие опции (такие как hidden и !hidden) не могут быть использованы вместе.
  • hidden: Только перечислять скрытые категории
  • !hidden: Не перечислять скрытые категории
• cllimit: Максимальное число результатов для возврата
• clcontinue: При доступности боáльшего числа результатов, использовать это для продолжения
• clcategories: Только перечислять эти категории. Полезно для проверки, принадлежит ли определённая страница определённой категории
  • Этот параметр принимает только полные названия, поэтому должен использоваться префикс Category:

Пример

Получение списка категорий, к которым принадлежит en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=categories [try in ApiSandbox]

Result
<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>

Возможные предупреждения

• ``title'' is not a category
  • Указанного названия нет в пространстве имён Category:

Возможные ошибки

• code: clshow
  • info: Некорректный параметр - взаимно исключающие значения не могут использоваться

imageinfo / ii

Версия MediaWiki:

1.11

Получает информацию о файлах в пространстве имён изображений

Параметры

• iiprop: Какие свойства получить
  • timestamp: Время и дата ревизии (по умолчанию)
  • user: Пользователь, создавший ревизию (по умолчанию)
  • comment: Комментарий правки
  • url: URL изображения
  • size: Размер изображения в байтах, ширина и высота
  • sha1: Хеш SHA-1 изображения
  • mime: Тип MIME изображения
  • metadata: Метаданные изображения, если присутствуют
  • archivename: Имя архива (только для старых изображений)
• iilimit: Число возвращаемых ревизий изображения (1 по умолчанию)
• iistart: Метка времени, с которой начинать перечисление
• iiend: Метка времени, на которой закончить перечисление
• iiurlwidth: Если установлен параметр iiprop=url, будет возвращён также URL изображения, масштабированного до заданной длины. Старые версии изображений не могут быть масштабированы
• iiurlheight: Схожее действие с iiurlwidth

Example

Получение информации о en:Image:Albert Einstein Head.jpg. Обратите внимание, что информация об изображении может отсутствовать, если файл существует на Викискладе.

api.php?action=query&titles=Image:Albert%20Einstein%20Head.jpg&prop=imageinfo [try in ApiSandbox]

Result
<?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

Версия MediaWiki:

1.9

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

Возвращаются только языковые ссылки для 50 названий

Параметры

• llimit - количество возвращаемых значений. по умолчанию 10. Не должно превышать 500 (5000 для ботов)
• llcontinue - есть еще результаты, используется для продолжения

Пример

Получить список языковых ссылок статьи en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=langlinks [try in ApiSandbox]

Result
<?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>

Возможные ошибки

Нет

links / pl

Версия MediaWiki:

1.9

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

Параметры

• plnamespace: Перечислять только ссылки на эти пространства имён
• pllimit: Сколько ссылок возвращать. По умолчанию 10. Разрешено не более 500 (5000 для ботов).
• plcontinue: Если ещё доступны результаты, используйте этот параметр для продолжения

Пример

Получить список ссылок со статьи en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=links [try in ApiSandbox]

Result

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

Возможные ошибки

Нет

templates / tl

Версия MediaWiki:

1.9

Получает список всех страниц, включённых в заданные страницы. Этот модуль может быть использован в качестве генератора.

Параметры

• tlnamespace: Перечислять только страницы в этом пространстве имён
• tllimit: Сколько шаблонов возвращать

Пример

Получение списка шаблонов, используемых в статье en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=templates [try in ApiSandbox]

Result
<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>

Возможные ошибки

Нет.

images / im

Версия MediaWiki:

1.9

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

Параметры

Нет.

Пример

Получения списка изображений статьи en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=images [try in ApiSandbox]

Result
<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>

Возможные ошибки

Нет.

extlinks / el

Версия MediaWiki:

1.11

Получение списка всех внешних ссылок на заданных страницах

Параметры

Нет.

Пример

Получение списка всех внешних ссылок на странице en:Albert Einstein

api.php?action=query&titles=Albert%20Einstein&prop=extlinks [try in ApiSandbox]

Result
<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>

Возможные ошибки

Нет.

categoryinfo / ci

Версия MediaWiki:

1.13

Получает информацию о категориях

Примечание

Если страница категории существует, но у категории нет членов, поле «categoryinfo» не будет включено в ответ API.

Параметры

Нет

Пример

Получение информации о нескольких категориях

api.php?action=query&titles=Albert%20Einstein|Category:Foo|Category:Infobox|Category:Templates_using_ParserFunctions&prop=categoryinfo [try in ApiSandbox]

Result

<?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>

Возможные ошибки

Нет

duplicatefiles / df

Версия MediaWiki:

1.14

Список дубликатов заданных файлов.

Параметры

• dflimit: Сколько дубликатов перечислять
• dfcontinue: Если ещё доступны результаты, используйте этот параметр для продолжения

Пример

Список дубликатов двух изображений

api.php?action=query&titles=Image:Bombers.ogg|Image:Welcome.gif&prop=duplicatefiles [try in ApiSandbox]

Result

<?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>

Возможные ошибки

Нет.