API:Query - Properties/ru

From MediaWiki.org

Jump to: navigation, search

Эта страница является частью документации по MediaWiki API.

Язык:	English • Deutsch • Español • 日本語 • Русский • Українська

MediaWiki API

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

[edit] info / in

MediaWiki version:

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

api.php ? action=query & titles=Albert%20Einstein & prop=info & inprop=protection|talkid

<?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] Возможные ошибки

Нет

[edit] revisions / rv

MediaWiki version:

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

[edit] Пример

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

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

<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

[edit] categories / cl

MediaWiki version:

1.11

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

[edit] Параметры

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

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=categories

<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: Некорректный параметр - взаимно исключающие значения не могут использоваться

[edit] imageinfo / ii

MediaWiki version:

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

[edit] Example

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

api.php ? action=query & titles=Image:Albert%20Einstein%20Head.jpg & prop=imageinfo

<?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] langlinks / ll

MediaWiki version:

1.9

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

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

[edit] Параметры

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

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=langlinks

<?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] links / pl

MediaWiki version:

1.9

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

[edit] Параметры

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

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=links

<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] Возможные ошибки

Нет

[edit] templates / tl

MediaWiki version:

1.9

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

[edit] Параметры

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

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=templates

<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] Возможные ошибки

Нет.

[edit] images / im

MediaWiki version:

1.9

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

[edit] Параметры

Нет.

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=images

<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] extlinks / el

MediaWiki version:

1.11

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

[edit] Параметры

Нет.

[edit] Пример

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

api.php ? action=query & titles=Albert%20Einstein & prop=extlinks

<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] Возможные ошибки

Нет.

[edit] categoryinfo / ci

MediaWiki version:

1.13

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

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

[edit] Параметры

Нет

[edit] Пример

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

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

<?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] Возможные ошибки

Нет

[edit] duplicatefiles / df

MediaWiki version:

1.14

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

[edit] Параметры

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

[edit] Пример

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

api.php ? action=query & titles=Image:Bombers.ogg|Image:Welcome.gif & prop=duplicatefiles

<?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] Возможные ошибки

Нет.

API:Query - Properties/ru

Contents

[edit] info / in

[edit] Параметры

[edit] Пример

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

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

[edit] revisions / rv

[edit] Параметры

[edit] Пример

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

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

[edit] categories / cl

[edit] Параметры

[edit] Пример

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

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

[edit] imageinfo / ii

[edit] Параметры

[edit] Example

[edit] langlinks / ll

[edit] Параметры

[edit] Пример

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

[edit] links / pl

[edit] Параметры

[edit] Пример

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

[edit] templates / tl

[edit] Параметры

[edit] Пример

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

[edit] images / im

[edit] Параметры

[edit] Пример

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

[edit] extlinks / el

[edit] Параметры

[edit] Пример

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

[edit] categoryinfo / ci

[edit] Параметры

[edit] Пример

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

[edit] duplicatefiles / df

[edit] Параметры

[edit] Пример

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

Personal tools

Namespaces

Variants

Views

Actions

Search

Site

Support

Download

Development

Communication

Print/export

Toolbox