API:Списки
Appearance
Эта страница является частью документации по API действий MediaWiki. |
GET-запрос на перечисление элементов, соответствующих выбранным критериям.
Документация по API
Списки обычно возвращают собранные данные, такие как собранные по всему вики страницы или собранные на одной странице ссылки. Чтобы востребовать список, передайте параметру list
вашего поиска действующий подмодуль списка, например allimages
или usercontribs
.
Чтобы использовать API списков, укажите action=query&list=list1|list2
в URL.
See individual list API pages for more concrete examples of how to use lists:
- allcategories
- alldeletedrevisions
- allfileusages
- allimages
- alllinks
- allpages
- allredirects
- allrevisions
- alltransclusions
- allusers
- backlinks
- blocks
- categorymembers
- deletedrevs
- embeddedin
- exturlusage
- filearchive
- imageusage
- iwbacklinks
- langbacklinks
- logevents
- pagepropnames
- pageswithprop
- prefixsearch
- protectedtitles
- querypage
- random
- recentchanges
- search
- tags
- usercontribs
- users
- watchlist
- watchlistraw
Дополнительная информация
- Most list submodules can be used as generators , unless otherwise noted.
- Списки отличаются от properties тем, что: они не добавляют данные в подэлементы элемента
pages
, каждый список обладает своей отдельной веткой в элементеquery
.
- List query limits:
- Предел результатов может быть установлен до 500 для обычных участников или 5000 для участников с правом на
apihighlimits
(обычно боты и администраторы). - Некоторые модули при некоторых условиях накладывают более строгие ограничения на пределы выдачи. Смотрите эту подстраницу для подробностей.
- Если вы не уверены, каков доступный вам предел, и хотите получить максимальное количество результатов за запрос, установите параметр предела как равный
max
. В этом случае будет возвращён элементlimits
, сообщающий использованные ограничения. - The limit parameter for a given module consists of the module prefix followed by
limit
, soptlimit
is the maximum number ofprotectedtitles
returned, andcmlimit
is the maximum number ofcategorymembers
returned.
- Предел результатов может быть установлен до 500 для обычных участников или 5000 для участников с правом на
См. также
- Maintained by MediaWiki Interfaces Team.
- Live chat (IRC): #mediawiki-core подключиться
- Issue tracker: Phabricator MediaWiki-Action-API (Report an issue)