Справка MediaWiki API
Это автоматически сгенерированная страница документации MediaWiki API.
Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=imageinfo (ii)
- Этот модуль требует прав на чтение.
- Источник: MediaWiki
- Лицензия: GPL-2.0-or-later
Возвращает информацию о файле и историю загрузок.
- 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
Если для свойства расширенных метаданных доступны переводы, запросить их все.
- Тип: булева (подробнее)
- iiextmetadatafilter
Если задано и непустое, только эти ключи будут возвращены для iiprop=extmetadata.
- Разделяйте значения с помощью | или альтернативного разделителя.
- Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
- iiurlparam
Строковой параметр, зависящий от обработчика. Например, для PDF можно использовать page15-100px. Должен быть использован iiurlwidth, не противоречащий с iiurlparam.
- По умолчанию: (пусто)
- iibadfilecontexttitle
Если задан badfilecontexttitleprop=badfile, этот заголовок страницы будет использован для анализа MediaWiki:Bad image list.
- iicontinue
Когда доступно больше результатов, используйте это для продолжения. Более подробную информацию о том, как продолжить запросы, можно найти на mediawiki.org.
- iilocalonly
Искать только файлы в локальном репозитории.
- Тип: булева (подробнее)
- Заросить информацию о текущей версии 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 [открыть в песочнице]