API:Списки

This page is a translated version of the page API:Lists and the translation is 76% complete.

Эта страница является частью документации по 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:

Дополнительная информация

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, so ptlimit is the maximum number of protectedtitles returned, and cmlimit is the maximum number of categorymembers returned.

См. также

Maintained by MediaWiki Interfaces Team.
Live chat (IRC): #mediawiki-core ^{подключиться}
Issue tracker: Phabricator MediaWiki-Action-API (Report an issue)