Справка MediaWiki API
Это автоматически сгенерированная страница документации MediaWiki API.
Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=query
(main | query)
- Этот модуль требует прав на чтение.
- Источник: MediaWiki
- Лицензия: GPL-2.0-or-later
Запросить данные с и о MediaWiki.
Все модификации данных сначала должны запросить соответствующий токен для предотвращения злоупотреблений с вредоносных сайтов.
Определённые параметры:
Other general parameters are available.
- prop
Какие использовать свойства для запрашиваемых страниц.
- categories
- Перечисление всех категорий, которым принадлежит страница.
- categoryinfo
- Возвращение информации о конкретных категориях.
- contributors
- Получение списка зарегистрированных и количества анонимных редакторов страницы.
- deletedrevisions
- Получение информации об удалённых правках.
- duplicatefiles
- Перечисление всех файлов, являющихся дубликатами данных, основываясь на сравнении хэш-сумм.
- extlinks
- Получение всех внешних ссылок (не интервик) для данной страницы.
- fileusage
- Поиск всех страниц, использующих данный файл.
- imageinfo
- Возвращает информацию о файле и историю загрузок.
- images
- Возвращает все файлы, содержащиеся на данных страницах.
- info
- Получение основной информации о страницах.
- iwlinks
- Возвращает все интервики-ссылки с данных страниц.
- langlinks
- Возвращает все межъязыковые ссылки с данных страниц.
- links
- Возвращает все ссылки с данных страниц.
- linkshere
- Поиск всех страниц, ссылающихся на данную.
- pageprops
- Получение различных свойств страниц, определённых в содержании страницы.
- redirects
- Возвращает все перенаправления на данную страницу.
- revisions
- Получение информации о версии страницы.
- stashimageinfo
- Возвращает информацию о файлах во временном хранилище.
- templates
- Возвращает все страницы, включённые в данную.
- transcludedin
- Поиск всех страниц, включающих данные страницы.
- Значения (разделённые с помощью | или альтернативного разделителя): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageprops, redirects, revisions, stashimageinfo, templates, transcludedin
- list
Какие списки использовать.
- allcategories
- Перечисление всех категорий.
- alldeletedrevisions
- Перечисление всех удалённых версий указанного участника или в указанном пространстве имён.
- allfileusages
- Перечисление всех использований файлов, в том числе несуществующих.
- allimages
- Перечисление всех файлов.
- alllinks
- Перечисление всех ссылок, указывающих на заданное пространство имён.
- allpages
- Перечисление всех страниц в данном пространстве имён.
- allredirects
- Перечисление всех перенаправлений на заданное пространство имён.
- allrevisions
- Перечисление всех версий.
- alltransclusions
- Перечисление всех включений (страниц, вставленных с помощью {{x}}), включая несуществующие.
- allusers
- Перечисление всех зарегистрированных участников.
- backlinks
- Получение списка страниц, ссылающихся на данную страницу.
- blocks
- Перечисление всех заблокированных участников и IP-адресов.
- categorymembers
- Перечисление всех страниц в данной категории.
- embeddedin
- Поиск всех страниц, встраивающих (включающих) данное название.
- exturlusage
- Перечислить страницы, содержащие данную ссылку.
- filearchive
- Перечисление всех удалённых файлов.
- gadgetcategories
- Возвращает список категорий гаджетов.
- gadgets
- Возвращает список гаджетов, используемых в этой вики.
- imageusage
- Поиск всех страниц, использующих данный файл.
- iwbacklinks
- Поиск всех страниц, ссылающихся на заданную интервики ссылку.
- langbacklinks
- Поиск всех страниц, ссылающихся на заданную языковую ссылку.
- logevents
- Получение записей журналов.
- mystashedfiles
- Получить список файлов во временном хранилище текущего участника.
- pagepropnames
- Перечисление всех названий свойств, использованных в вики.
- pageswithprop
- Перечисление всех страниц, использующих заданное свойство.
- prefixsearch
- Осуществление поиска по префиксу названий страниц.
- protectedtitles
- Перечисление всех названий, защищённых от создания.
- querypage
- Получение списка, предоставляемого служебной страницей, основанной на QueryPage.
- random
- Получение набора случайных страниц.
- recentchanges
- Перечисление последних правок.
- search
- Проведение полнотекстового поиска.
- tags
- Список меток правок.
- usercontribs
- Получение всех правок участника.
- users
- Получение информации о списке участников.
- watchlist
- Получение последних правок страниц из списка наблюдения текущего участника.
- watchlistraw
- Получение всех страниц из списка наблюдения текущего участника.
- deletedrevs
- Устарело. Перечисление удалённых правок.
- Значения (разделённые с помощью | или альтернативного разделителя): allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, blocks, categorymembers, embeddedin, exturlusage, filearchive, gadgetcategories, gadgets, imageusage, iwbacklinks, langbacklinks, logevents, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw, deletedrevs
- meta
Какие метаданные использовать.
- allmessages
- Возвращает сообщения с этого сайта.
- authmanagerinfo
- Получение информации о текущем статусе аутентификации.
- filerepoinfo
- Возвращает мета-информацию о файловых репозиториях, настроенных в вики.
- languageinfo
- Возвращает информацию о доступных языках.
- siteinfo
- Получение основной информации о сайте.
- tokens
- Получение токенов для действий, связанных с редактированием данных.
- userinfo
- Получение информации о текущем участнике.
- Значения (разделённые с помощью | или альтернативного разделителя): allmessages, authmanagerinfo, filerepoinfo, languageinfo, siteinfo, tokens, userinfo
- indexpageids
Включить дополнительный раздел pageids, содержащий список идентификаторов всех возвращённых страниц.
- Тип: булева (подробнее)
- export
Экспортировать текущую версию для всех данных или созданных страниц.
- Тип: булева (подробнее)
- exportnowrap
Вернуть экспортируемый XML без оборачивания его в XML-результат (тот же формат, что и в Special:Export). Можно использовать только одновременно с query+export.
- Тип: булева (подробнее)
- exportschema
При экспорте ориентироваться на заданную версию формата XML дампа. Может использоваться только вместе с query+export.
- Одно из следующих значений: 0.10, 0.11
- По умолчанию: 0.11
- iwurl
Возвращать ли полную ссылку, если названием является интервики-ссылка.
- Тип: булева (подробнее)
- continue
Когда доступно больше результатов, используйте это для продолжения. Более подробную информацию о том, как продолжить запросы, можно найти на mediawiki.org.
- rawcontinue
Вернуть сырые данные в query-continue для продолжения.
- Тип: булева (подробнее)
- titles
Список заголовков для работы.
- Разделяйте значения с помощью | или альтернативного разделителя.
- Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
- pageids
Список идентификаторов страниц для работы.
- Тип: список целочисленных значений
- Разделяйте значения с помощью | или альтернативного разделителя.
- Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
- revids
Список идентификаторов версий для работы. Обратите внимание, что почти все модули запросов преобразуют идентификаторы версий в соответствующие идентификаторы страниц и вместо этого работают с последней версией. Только prop=revisions использует в своём ответе точные версии.
- Тип: список целочисленных значений
- Разделяйте значения с помощью | или альтернативного разделителя.
- Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
- generator
Получить список страниц для работы, запустив указанный запрос-модуль.
Примечание: названия параметров генераторов должны начинаться с «g», см. примеры.
- allcategories
- Перечисление всех категорий.
- alldeletedrevisions
- Перечисление всех удалённых версий указанного участника или в указанном пространстве имён.
- allfileusages
- Перечисление всех использований файлов, в том числе несуществующих.
- allimages
- Перечисление всех файлов.
- alllinks
- Перечисление всех ссылок, указывающих на заданное пространство имён.
- allpages
- Перечисление всех страниц в данном пространстве имён.
- allredirects
- Перечисление всех перенаправлений на заданное пространство имён.
- allrevisions
- Перечисление всех версий.
- alltransclusions
- Перечисление всех включений (страниц, вставленных с помощью {{x}}), включая несуществующие.
- backlinks
- Получение списка страниц, ссылающихся на данную страницу.
- categories
- Перечисление всех категорий, которым принадлежит страница.
- categorymembers
- Перечисление всех страниц в данной категории.
- deletedrevisions
- Получение информации об удалённых правках.
- duplicatefiles
- Перечисление всех файлов, являющихся дубликатами данных, основываясь на сравнении хэш-сумм.
- embeddedin
- Поиск всех страниц, встраивающих (включающих) данное название.
- exturlusage
- Перечислить страницы, содержащие данную ссылку.
- fileusage
- Поиск всех страниц, использующих данный файл.
- images
- Возвращает все файлы, содержащиеся на данных страницах.
- imageusage
- Поиск всех страниц, использующих данный файл.
- iwbacklinks
- Поиск всех страниц, ссылающихся на заданную интервики ссылку.
- langbacklinks
- Поиск всех страниц, ссылающихся на заданную языковую ссылку.
- links
- Возвращает все ссылки с данных страниц.
- linkshere
- Поиск всех страниц, ссылающихся на данную.
- pageswithprop
- Перечисление всех страниц, использующих заданное свойство.
- prefixsearch
- Осуществление поиска по префиксу названий страниц.
- protectedtitles
- Перечисление всех названий, защищённых от создания.
- querypage
- Получение списка, предоставляемого служебной страницей, основанной на QueryPage.
- random
- Получение набора случайных страниц.
- recentchanges
- Перечисление последних правок.
- redirects
- Возвращает все перенаправления на данную страницу.
- revisions
- Получение информации о версии страницы.
- search
- Проведение полнотекстового поиска.
- templates
- Возвращает все страницы, включённые в данную.
- transcludedin
- Поиск всех страниц, включающих данные страницы.
- watchlist
- Получение последних правок страниц из списка наблюдения текущего участника.
- watchlistraw
- Получение всех страниц из списка наблюдения текущего участника.
- Одно из следующих значений: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
- redirects
Автоматически разрешать перенаправления в query+titles, query+pageids и query+revids, а также на страницах, возвращённых query+generator.
- Тип: булева (подробнее)
- converttitles
Преобразовать заголовки в другой вариант, если это необходимо. Работает только если язык содержимого вики поддерживает преобразование вариантов. Языки, поддерживающие преобразование, включают ban, en, crh, gan, iu, ku, sh, shi, sr, tg, tly, uz, wuu и zh.
- Тип: булева (подробнее)
Примеры:
- Получить информацию о сайте и версии для Народный Брифли.
- api.php?action=query&prop=revisions&meta=siteinfo&titles=%D0%9D%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D1%8B%D0%B9%20%D0%91%D1%80%D0%B8%D1%84%D0%BB%D0%B8&rvprop=user|comment&continue= [открыть в песочнице]
- Получить последнее изменение для страниц, начиная с API/.
- api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue= [открыть в песочнице]