API:Списки

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Lists and the translation is 65% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎polski • ‎română • ‎русский • ‎українська • ‎العربية • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

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:
    • Если предел не указан клиентом, используется предел по умолчанию — 10, а клиент может указать значение до 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.

См. также