Справка MediaWiki API

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

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

prop=imageinfo (ii)

(main | query | imageinfo)

Этот модуль требует прав на чтение.
Источник: MediaWiki
Лицензия: GPL-2.0-or-later

Возвращает информацию о файле и историю загрузок.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Imageinfo

Определённые параметры:

Other general parameters are available.

iiprop

Какую информацию о файле получить:

timestamp: Добавляет метку времени загрузки файловой версии.
user: Добавляет участников, загрузивших каждую файловую версию. Если версия пользователя была удалена, будет возвращено свойство userhidden.
userid: Добавляет идентификаторы участников, загрузивших каждую файловую версию. Если версия пользователя была удалена, будет возвращено свойство userhidden.
comment: Комментарий к версии. Если комментарий был удален, будет возвращено свойство commenthidden.
parsedcomment: Распарсенный комментарий к версии. Если комментарий был удален, будет возвращено свойство commenthidden.
canonicaltitle: Добавляет каноничное название файла. Если версия файла была удалена, будет возвращено свойство filehidden.
url: Возвращает ссылку на файл и страницу описания. Если версия файла была удалена, будет возвращено свойство filehidden.
size: Добавляет размер файла в байтах, высоту, ширину и количество использующих страниц (если применимо).
dimensions: Синоним для size.
sha1: Добавляет SHA1-хэш файла. Если версия файла была удалена, будет возвращено свойство filehidden.
mime: Добавляет MIME-тип файла. Если версия файла была удалена, будет возвращено свойство filehidden.
thumbmime: Добавляет MIME-тип миниатюры файла (требуется url и параметр iiurlwidth). Если версия файла была удалена, будет возвращено свойство filehidden.
mediatype: Добавляет медиа-тип файла. Если версия файла была удалена, будет возвращено свойство filehidden.
metadata: Перечисляет метаданные Exif для файловой версии. Если версия файла была удалена, будет возвращено свойство filehidden.
commonmetadata: Перечисляет общие для данного формата метаданные для файловой версии. Если версия файла была удалена, будет возвращено свойство filehidden.
extmetadata: Перечисляет структурированные метаданные, собранные из нескольких источников. Результат отдаётся в формате HTML. Если версия файла была удалена, будет возвращено свойство filehidden.
archivename: Добавляет имя архивной версии файла. Если версия файла была удалена, будет возвращено свойство filehidden.
bitdepth: Добавляет глубину цвета файловой версии. Если версия файла была удалена, будет возвращено свойство filehidden.
uploadwarning: Используется страницей Special:Upload для получения информации о существовании файла. Не предназначено для использования за пределами ядра MediaWiki.
badfile: Добавляет указание на то, находится ли файл в списке MediaWiki:Bad image list

Значения (разделённые с помощью | или альтернативного разделителя): archivename, badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, thumbmime, timestamp, uploadwarning, url, user, userid

По умолчанию: timestamp|user

iilimit

Сколько версий каждого файла вернуть.

Тип: целое число или max

Значение должно быть между 1 и 500.

По умолчанию: 1

iistart

Временная метка, с которой начать перечисление.

Тип: временная метка (разрешённые форматы)

iiend

Временная метка, на которой закончить перечисление.

Тип: временная метка (разрешённые форматы)

iiurlwidth

Если задан iiprop=url, будет возвращена ссылка на изображение, масштабированное до указанной ширины. Из соображений производительности, при использовании этой опции будет возвращено не более 50 файлов.

Тип: целочисленное значение

По умолчанию: -1

iiurlheight

Аналогично iiurlwidth.

Тип: целочисленное значение

По умолчанию: -1

iimetadataversion

Какую версию метаданных использовать. Если указано latest, будет использована последняя версия. Для обратной совместимости, значение по умолчанию — 1.

По умолчанию: 1

iiextmetadatalanguage

На каком языке запрашивать расширенные метаданные. Это затрагивает как переводы, если их доступно несколько, так и способ форматирования чисел и других значений.

По умолчанию: ru

iiextmetadatamultilang

Если для свойства расширенных метаданных доступны переводы, запросить их все.

Type: boolean (details)

iiextmetadatafilter

Если задано и непустое, только эти ключи будут возвращены для iiprop=extmetadata.

Разделяйте значения с помощью | или альтернативного разделителя.

Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).

iiurlparam

Строковой параметр, зависящий от обработчика. Например, для PDF можно использовать page15-100px. Должен быть использован iiurlwidth, не противоречащий с iiurlparam.

По умолчанию: (пусто)

iibadfilecontexttitle

Если задан badfilecontexttitleprop=badfile, этот заголовок страницы будет использован для анализа MediaWiki:Bad image list.

iicontinue

Когда доступно больше результатов, используйте это для продолжения. Более подробную информацию о том, как продолжить запросы, можно найти на mediawiki.org.

iilocalonly

Искать только файлы в локальном репозитории.

Type: boolean (details)

Примеры:

Заросить информацию о текущей версии File:Albert Einstein Head.jpg.: api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [открыть в песочнице]
Запросить информацию о версиях File:Test.jpg с 2008 года и позже.: api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [открыть в песочнице]