API:Случайная страница

API действий MediaWiki
Основы Все модули запросов Получение свойств страниц Перечисление страниц, соответствующих какому-либо критерию Получение информации о параметрах модуля Получение данных о самой вики и об участниках Аутентификация Получение токенов для действий, изменяющих данные Вход Выход Учётные записи и участники Создание учётной записи Блокировка и разблокировка участников Get info about the current user Получение списка наблюдения текущего участника как ленты Изменение настроек участника Изменение членства участников в группах Отправка эл. почты Выполнение операций со страницами Синтаксический разбор викитекста и раскрытие шаблонов Создание и редактирование страниц Загрузка файлов Импорт страниц Удаление страниц Внесение или удаление страницы из списка наблюдения Очистка кэша страниц Выполнение отката на странице Переименование страниц Патрулирование изменений Восстановление версий удалённых страниц Изменение уровня защиты страниц Изменение языка страницы Ещё... Поиск Поиск по названию или тексту Получение результатов в формате OpenSearch Поиск страниц вики об объектах, расположенных рядом с каким-либо местом Поиск языка Выполнение префиксного поиска по названиям страниц Сведения для разработчиков Библиотеки для выполнения запросов Межсайтовые запросы Создание модуля API в расширении Использование API в MediaWiki и расширениях Ограничение использования Локализация Implementation Strategy Tutorials Action API Tutorial Article ideas generator Nearby places viewer Picture of the day viewer

Версия MediaWiki:

≥ 1.12

Получить список случайных страниц.

This module can be used as a generator .

API documentation

list=random (rn) (main | query | random) This module requires read rights. This module can be used as a generator. Source: MediaWiki License: GPL-2.0-or-later Get a set of random pages. Pages are listed in a fixed sequence, only the starting point is random. This means that if, for example, Main Page is the first random page in the list, List of fictional monkeys will always be second, List of people on stamps of Vanuatu third, etc. https://www.mediawiki.org/wiki/Special:MyLanguage/API:Random Parameters: rnnamespace Return pages in these namespaces only. Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 486, 487, 828, 829, 1198, 1199, 2300, 2301, 2302, 2303, 2600, 5500, 5501 To specify all values, use *. rnfilterredir How to filter for redirects. One of the following values: all, redirects, nonredirects Default: nonredirects rnredirect Deprecated. Use rnfilterredir=redirects instead. Type: boolean (details) rnlimit Limit how many random pages will be returned. No more than 500 (5,000 for bots) allowed. Type: integer or max Default: 1 rncontinue When more results are available, use this to continue. Examples: Return two random pages from the main namespace. api.php?action=query&list=random&rnnamespace=0&rnlimit=2 [open in sandbox] Return page info about two random pages from the main namespace. api.php?action=query&generator=random&grnnamespace=0&grnlimit=2&prop=info [open in sandbox]

Пример

GET-запрос

Список 5 случайных страниц

api.php?action=query&format=json&list=random&rnlimit=5 [попробуйте в ApiSandbox]

Ответ

{

"batchcomplete": "",
    "continue": {
        "rncontinue": "0.559881820010|0.559881954661|47659388|0",
        "continue": "-||"
    },
    "query": {
        "random": [
            {
                "id": 32381675,
                "ns": 0,
                "title": "Mallabhum Institute of Technology"
            },
            {
                "id": 25126452,
                "ns": 3,
                "title": "User talk:96.232.132.176"
            },
            {
                "id": 1440028,
                "ns": 0,
                "title": "Hyundai Epsilon engine"
            },
            {
                "id": 35446805,
                "ns": 15,
                "title": "Category talk:Ukrainian card games"
            },
            {
                "id": 12613,
                "ns": 0,
                "title": "Grue"
            }
        ]
    }
}

Пример кода

get_random.py

#!/usr/bin/python3

"""
    get_random.py

    MediaWiki Action API Code Samples
    Demo of `Random` module: Get a list of 5 random pages
    MIT license
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action":"query",
    "format":"json",
    "list": "random",
    "rnlimit": "5"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

print(DATA)

История параметров

• v1.26: Previous limit of 10/20 on rnlimit was increased to standard 500/5000 limits.
• v1.26: Deprecated rnredirect
• v1.26: Introduced rnfilterredir
• v1.14: Introduced rnredirect

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

• Unlike most modules in the Action API , the default number of pages returned is 1, not 10.
• Страницы возвращаются в фиксированном порядке; только первая страница на самом деле случайна.
• Поведение по умолчанию - выбирать страницы со всего вики, включая страницы обсуждения, пользовательские страницы, и так далее. Если в ищете такую же функциональность как Special:Random, т. е. выбор случайных статьей, ограничте rnnamespace на 0.
• Если количество страниц меньше чем rnlimit, запрос просто вернёт все доступные страницы. Он не будет повторять страницы, чтобы наполнить ответ до ограничения.

См. также

• Manual:Random page - describes how to configure the API on the backend.