API:Токены

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

Версия 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+\\"
        }
    }
}

Пример кода

Python

#!/usr/bin/python3

"""
    tokens.py
    MediaWiki API Demos
    Demo of `Token` module: Fetch token of type `login`
    MIT License
"""

import requests

S = requests.Session()

URL = "https://www.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)

PHP

<?php

/*
    tokens.php

    MediaWiki API Demos
    Demo of `Token` module: Fetch token of type `login`

    MIT License
*/

$endPoint = "https://www.mediawiki.org/w/api.php";
$params = [
    "action" => "query",
    "meta" => "tokens",
    "type" => "login",
    "format" => "json"
];

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

$result = json_decode( $output, true );
echo( $result['query']['tokens']['logintoken'] . "\n" );

JavaScript

/*
    tokens.js
    MediaWiki API Demos
    Demo of `Token` module: Fetch token of type `login`
    MIT License
*/

var request = require('request'),
    url = "https://www.mediawiki.org/w/api.php";

var params = {
    action: "query",
    meta: "tokens",
    type: "login",
    format: "json"
};

request.get( { url: url, qs: params }, function( error, response, body ){
    body = JSON.parse( body );
    console.log( body.query.tokens.logintoken );
});

MediaWiki JS

/*
    tokens.js
    MediaWiki API Demos
    Demo of `Token` module: Fetch token of type `csrf`
    MIT License
*/

var params = {
		action: 'query',
		meta: 'tokens',
		type: 'csrf',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	console.log( data.query.tokens.csrftoken );
} );

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

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

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

• v1.27: Введены login, createaccount

См. также

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