Jump to content

API:Query - Properties/ru

From mediawiki.org

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

info / in

[edit]
Версия MediaWiki:
1.9

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

Параметры

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

Пример

[edit]
Получение информации о странице en:Albert Einstein
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>

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

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

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

[edit]

Нет

revisions / rv

[edit]
Версия MediaWiki:
1.8

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

Параметры

[edit]
  • 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: Токены для каждой ревизии

Пример

[edit]
Получить данные, включающие содержание последней ревизии страниц en:API и en:Main Page
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>

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

[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

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

Параметры

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

Пример

[edit]
Получение списка категорий, к которым принадлежит en:Albert Einstein
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>

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

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

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

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

imageinfo / ii

[edit]
Версия MediaWiki:
1.11

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

Параметры

[edit]
  • 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

[edit]
Получение информации о en:Image:Albert Einstein Head.jpg. Обратите внимание, что информация об изображении может отсутствовать, если файл существует на Викискладе.
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>
[edit]
Версия MediaWiki:
1.9

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

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

Параметры

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

Пример

[edit]
Получить список языковых ссылок статьи en:Albert Einstein
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>

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

[edit]

Нет

[edit]
Версия MediaWiki:
1.9

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

Параметры

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

Пример

[edit]
Получить список ссылок со статьи en:Albert Einstein
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>

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

[edit]

Нет

templates / tl

[edit]
Версия MediaWiki:
1.9

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

Параметры

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

Пример

[edit]
Получение списка шаблонов, используемых в статье en:Albert Einstein
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>

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

[edit]

Нет.

images / im

[edit]
Версия MediaWiki:
1.9

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

Параметры

[edit]

Нет.

Пример

[edit]
Получения списка изображений статьи en:Albert Einstein
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>

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

[edit]

Нет.

[edit]
Версия MediaWiki:
1.11

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

Параметры

[edit]

Нет.

Пример

[edit]
Получение списка всех внешних ссылок на странице en:Albert Einstein
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>

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

[edit]

Нет.

categoryinfo / ci

[edit]
Версия MediaWiki:
1.13

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

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

Параметры

[edit]

Нет

Пример

[edit]
Получение информации о нескольких категориях
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>

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

[edit]

Нет

duplicatefiles / df

[edit]
Версия MediaWiki:
1.14

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

Параметры

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

Пример

[edit]
Список дубликатов двух изображений
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>

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

[edit]

Нет.