API:Токены

API действий MediaWiki
Основы Все модули запросов Получение свойств страниц Перечисление страниц, соответствующих какому-либо критерию Получение информации о параметрах модуля Получение данных о самой вики и об участниках Аутентификация Получение токенов для действий, изменяющих данные Вход Выход Подтверждение статуса как участника Учётные записи и участники Создание учётной записи Блокировка и разблокировка участников Получение списка наблюдения текущего участника как ленты Изменение настроек участника Изменение членства участников в группах Отправка эл. почты Выполнение операций со страницами Синтаксический разбор викитекста и раскрытие шаблонов Создание и редактирование страниц Загрузка файлов Импорт страниц Удаление страниц Внесение или удаление страницы из списка наблюдения Очистка кэша страниц Выполнение отката на странице Переименование страниц Патрулирование изменений Восстановление версий удалённых страниц Изменение уровня защиты страниц Изменение языка страницы Ещё... Поиск Поиск по названию или тексту Получение результатов в формате OpenSearch Поиск страниц вики об объектах, расположенных рядом с каким-либо местом Поиск языка Выполнение префиксного поиска по названиям страниц Сведения для разработчиков Библиотеки для выполнения запросов Межсайтовые запросы Создание модуля API в расширении Использование API в MediaWiki и расширениях Ограничение использования Локализация Стратегия реализации

Версия MediaWiki:

≥ 1.24

Модуль API tokens позволяет получить токены, необходимые для выполнения изменяющих данные вики действий. Среди них протоколируемые действия, редактирование и переименовывание страниц, изменение списка наблюдения и патрулирование правок. Для каждого действия необходим токен какого-либо конкретного типа. Например, если вы хотите войти в учётную запись вики посредством API, вам понадобится токен типа «login» для выполнения этой операции.

Документация по API

meta=tokens (main | query | tokens) Source: MediaWiki License: GPL-2.0-or-later Gets tokens for data-modifying actions. https://www.mediawiki.org/wiki/Special:MyLanguage/API:Tokens Parameter: type Types of token to request. Values (separate with | or alternative): createaccount, csrf, deleteglobalaccount, login, patrol, rollback, setglobalaccountstatus, userrights, watch Default: csrf Examples: Retrieve a csrf token (the default). api.php?action=query&meta=tokens [open in sandbox] Retrieve a watch token and a patrol token. api.php?action=query&meta=tokens&type=watch|patrol [open in sandbox]

Пример

GET-запрос

api.php?action=query&meta=tokens&format=json&type=login [попробуйте в ApiSandbox]

Ответ

{
    "batchcomplete": "",
    "query": {
        "tokens": {
            "logintoken": "9ed1499d99c0c34c73faa07157b3b6075b427365+\\"
        }
    }
}

Пример кода

Tokens.py

/* 

 #!/usr/bin/python3

"""
    tokens.py

    MediaWiki Action API Code Samples
    Demo of `Token` module: Fetch token of type `login`
    MIT license
"""

import requests

S = requests.Session()

URL = "https://mediawiki.org/w/api.php"

PARAMS = {
    'action':"query",
    'meta':"tokens",
    'type':"login",
    'format':"json"
}

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

LOGIN_TOKEN = DATA['query']['tokens']['logintoken']

print(LOGIN_TOKEN)

Возможные ошибки

Код	Информация
Unrecognized value for parameter "type": xxx	Token type 'xxx is not valid

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

• v1.27: Introduced login, createaccount

См. также

• API:Расширения#Токен правки
• Устаревший метод получения токенов: API:Tokens (action)