API:Query - Properties/ru

From MediaWiki.org
Jump to navigation Jump to search

Свойства используются для получения различных данных о списке страниц, определённых либо с помощью параметров 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

Возможные предупреждения[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

Возможные предупреждения[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

Возможные предупреждения[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. Обратите внимание, что информация об изображении может отсутствовать, если файл существует на Викискладе.

langlinks / ll[edit]

Версия MediaWiki: 1.9

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

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

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

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

Пример[edit]

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

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

Нет

links / pl[edit]

Версия MediaWiki: 1.9

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

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

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

Пример[edit]

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

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

Нет

templates / tl[edit]

Версия MediaWiki: 1.9

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

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

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

Пример[edit]

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

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

Нет.

images / im[edit]

Версия MediaWiki: 1.9

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

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

Нет.

Пример[edit]

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

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

Нет.

extlinks / el[edit]

Версия MediaWiki: 1.11

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

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

Нет.

Пример[edit]

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

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

Нет.

categoryinfo / ci[edit]

Версия MediaWiki: 1.13

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

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

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

Нет

Пример[edit]

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

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

Нет

duplicatefiles / df[edit]

Версия MediaWiki: 1.14

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

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

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

Пример[edit]

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

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

Нет.