Справка MediaWiki API

Действие, которое следует выполнить.

block

Блокировка участника.

changeauthenticationdata

Смена параметров аутентификации для текущего участника.

changecontentmodel

Изменить модель содержимого страницы

checktoken

Проверить корректность токена из action=query&meta=token.

clearhasmsg

Очистить флаг hasmsg для текущего участника.

clientlogin

Вход в вики с помощью интерактивного потока.

compare

Получение разницы между двумя страницами.

createaccount

Создание новой учётной записи.

delete

Удаление страницы.

edit

Создание и редактирование страниц.

emailuser

Написание электронных писем участнику.

expandtemplates

Разворачивание всех шаблонов в вики-текст.

feedcontributions

Возвращает ленту с вкладом участников.

feedrecentchanges

Возвращает ленту последних изменений.

feedwatchlist

Возвращает ленту списка наблюдения.

filerevert

Возвращение файла к старой версии.

help

Отображение справки указанных модулей.

imagerotate

Поворот одного или нескольких изображений.

import

Импорт страницы из другой вики или XML-файла.

linkaccount

Связать аккаунт третьей стороны с текущим участником.

login

Вход и получение аутентификационных cookie.

logout

Выйти и очистить данные сессии.

managetags

Осуществление задач, связанных с изменением меток.

mergehistory

Объединение историй правок.

move

Переименование страницы.

opensearch

Поиск по вики с использованием протокола OpenSearch.

options

Смена настроек текущего участника.

paraminfo

Получение информации о модулях API.

parse

Парсит содержимое и возвращает результат парсинга.

patrol

Патрулирование страницы или версии.

protect

Изменение уровня защиты страницы.

purge

Очистка кэша заданных страниц.

query

Запросить данные с и о MediaWiki.

removeauthenticationdata

Удаление аутентификационных данных для текущего участника.

resetpassword

Отправить участнику письмо для сброса пароля.

revisiondelete

Удаление и восстановление версий страниц.

rollback

Отмена последней правки на странице.

rsd

Экспорт схемы RSD (Really Simple Discovery).

setnotificationtimestamp

Обновление временной метки уведомления для отслеживаемых страниц.

setpagelanguage

Изменить язык страницы.

tag

Добавление или удаление меток отдельных правок или записей журналов.

unblock

Разблокировка участника.

undelete

Восстановление версий удалённой страницы.

unlinkaccount

Удаление связанного стороннего аккаунта с текущим участником.

upload

Загрузка файла или получение статуса незавершённых загрузок.

userrights

Изменение групп участника.

validatepassword

Проверка пароля на удовлетворение политики вики.

watch

Добавление или удаление страниц из списка наблюдения текущего участника.

cspreport

Внутренний. Используется браузерами, чтобы сообщать о нарушениях политики безопасности (CSP). Этот модуль никогда не должен использоваться, за исключением случаев автоматического использования совместимыми с CSP браузерами.

stashedit

Внутренний. Подготовка правки в общем кэше.

Формат вывода.

json

Выводить данные в формате JSON.

jsonfm

Выводить данные в формате JSON (отформатированном в HTML).

none

Ничего не выводить.

php

Выводить данные в сериализованном формате PHP.

phpfm

Выводить данные в сериализованном формате PHP (отформатированном в HTML).

rawfm

Выводить данные, включая элементы отладки, в формате JSON (отформатированном в HTML).

xml

Выводить данные в формате XML.

xmlfm

Выводить данные в формате XML (отформатированном в HTML).

Значение максимального отставания может использоваться, когда MediaWiki установлена на кластер из реплицируемых баз данных. Чтобы избежать ухудшения ситуации с отставанием репликации сайта, этот параметр может заставить клиента ждать, когда задержка репликации станет ниже указанного значения. В случае чрезмерной задержки возвращается код ошибки «maxlag» с сообщением «Waiting for $host: $lag seconds lagged».
См. подробнее на странице с описанием Manual: параметра Maxlag.

Установить значение HTTP-заголовка Cache-Control s-maxage в заданное число секунд. Ошибки никогда не кэшируются.

Установить значение HTTP-заголовка Cache-Control max-age в заданное число секунд. Ошибки никогда не кэшируются.

Проверить, авторизован ли участник, если задано user, not авторизирован если задано anon или что он имеет права бота, если задано bot.

Проверить, что ник текущего участника совпадает с заданным.

Любое заданное здесь значение будет включено в ответ. Может быть использовано для различения запросов.

Включить в результаты имя хоста, обработавшего запрос.

Включить в результат временную метку.

Включить языки, использованные для uselang и errorlang, в результат.

При обращении к API с использованием кросс-доменного AJAX-запроса (CORS), задайте параметру значение исходного домена. Этот параметр должен быть включён в любой предварительный запрос и таким образом должен быть частью URI-запроса (не тела POST).

Для аутентифицированных запросов он должен точно соответствовать одному из источников в заголовке Origin, так что он должен быть задан наподобие https://ru.wikipedia.org или https://meta.wikimedia.org. Если параметр не соответствует заголовку Origin, будет возвращён ответ с кодом ошибки 403. Если параметр соответствует заголовку Origin, и источник разрешается, будут установлены заголовки Access-Control-Allow-Origin и Access-Control-Allow-Credentials.

Для неаутентифицированных запросов укажите значение *. В результате заголовок Access-Control-Allow-Origin будет установлен, но Access-Control-Allow-Credentials примет значение false и все пользовательские данные будут ограничены.

Язык, используемый для перевода сообщений. Запрос action=query&meta=siteinfo с siprop=languages возвращает список кодов языков; укажите user, чтобы использовать текущие языковые настройки участника, или content для использования основного языка этой вики.

Формат, используемый для вывода текста предупреждений и ошибок

plaintext

Wikitext with HTML tags removed and entities replaced.

wikitext

Unparsed wikitext.

html

HTML

raw

Message key and parameters.

none

No text output, only the error codes.

bc

Format used prior to MediaWiki 1.29. errorlang and errorsuselocal are ignored.

Язык, используемый для вывода предупреждений и сообщений об ошибках. Запрос action=query&meta=siteinfo с siprop=languages возвращает список кодов языков; укажите content для использования основного языка этой вики, или uselang для использования того же значения, что и в параметре uselang.

Если задан, тексты ошибок будут использовать локально модифицированные сообщения из пространства имён MediaWiki.

Имя участника, которого вы хотите заблокировать.

Вместо этого укажите user=#ID.

Время истечения срока действия. Может быть относительным (например, 5 months или 2 weeks) или абсолютным (например, 2014-09-18T12:34:56Z). Если задано infinite, indefinite или never, блокировка никогда не истечёт.

Причина блокировки.

Заблокировать только анонимных участников (т. е. запретить анонимные правки для этого IP-адреса).

Запретить создание учётных записей.

Автоматически блокировать последний использованный IP-адрес и все последующие, с которых будут совершаться попытки авторизации.

Запретить участнику отправлять электронную почту через интерфейс вики. (Требуется право blockemail).

Скрыть имя участника из журнала блокировок. (Требуется право hideuser).

Разрешить участнику редактировать свою страницу обсуждения (зависит от $wgBlockAllowsUTEdit).

Если участник уже заблокирован, перезаписать существующую блокировку.

Следить за страницей участника и соответствующей страницей обсуждения, принадлежащей участнику или IP-адресу.

Изменить метки записи в журнале блокировок.

Блокировать пользователю доступ только к определённым страницам или пространствам имён, а не ко всему сайту.

Список заголовков страниц, редактирование которых заблокировано для этого участника. Действителен, только если partial установлен в true.

Список пространств имён, редактирование в которых заблокировано для этого участника. Действителен, только если partial установлен в true.

Токен «csrf», полученный из action=query&meta=tokens

Использовать этот аутентификационный запрос, с id, возвращённом из action=query&meta=authmanagerinfo с amirequestsfor=change.

Токен «csrf», полученный из action=query&meta=tokens

Title of the page to change the contentmodel of. Cannot be used together with pageid.

Page ID of the page to change the contentmodel of. Cannot be used together with title.

Изменить сводку и причину записи в журнале

Change tags to apply to the log entry and edit.

Модель нового содержимого.

Пометьте изменение модели содержимого с помощью флага бота.

Токен «csrf», полученный из action=query&meta=tokens

Тип проверяемого токена.

Проверяемый токен.

Максимально допустимый возраст токена (в секундах).

Использовать только эти аутентификационные запросы, с id, возвращённом из action=query&meta=authmanagerinfo с amirequestsfor=login, или из предыдущего ответа этого модуля.

Формат, используемый для возвращаемых сообщений.

Слить поля информации со всех аутентификационных запросов в один массив.

Сохранить состояние с предыдущей провалившейся попытки авторизации, если возможно.

Вернуть ссылку для стороннего процесса аутентификации, должна быть абсолютной. Либо этот параметр, либо logincontinue, обязателен.

После получения ответа REDIRECT, вы, как правило, должны открыть в браузере или вэб-просмотрщике указанную в redirecttarget ссылку для продолжения стороннего процесса аутентификации. По завершению, сторонний сервис отошлёт браузеру или веб-просмотрщику эту ссылку. Вы должны извлечь все параметры из ссылки и отослать их в параметр logincontinue запроса к этому модулю.

Этот запрос — продолжение после предшествующего ответа UI или REDIRECT. Либо этот параметр, либо loginreturnurl, обязателен.

Токен «login», полученный из action=query&meta=tokens

Заголовок первой сравниваемой страницы.

Идентификатор первой сравниваемой страницы.

Первая сравниваемая версия.

Переопределение содержимого версии, заданной параметром fromtitle, fromid или fromrev.

Этот параметр определяет слоты, которые должны быть изменены. Используйте fromtext-{slot}, fromcontentmodel-{slot}, и fromcontentformat-{slot} для определения содержимого для каждого слота.

Text of the specified slot. If omitted, the slot is removed from the revision.

When fromtext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by fromtitle, fromid or fromrev as if for a section edit.

Content serialization format of fromtext-{slot}.

Content model of fromtext-{slot}. If not supplied, it will be guessed based on the other parameters.

Выполнить преобразование перед записью правки (PST) над fromtext-{slot}.

Укажите fromslots=main и используйте fromtext-main.

Укажите fromslots=main и используйте fromcontentformat-main.

Укажите fromslots=main и используйте fromcontentmodel-main.

Использовать только указанную секцию из содержимого «from».

Заголовок второй сравниваемой страницы.

Идентификатор второй сравниваемой страницы.

Вторая сравниваемая версия.

Использовать версию, относящуюся к определённой fromtitle, fromid или fromrev. Все другие опции 'to' будут проигнорированы.

Override content of the revision specified by totitle, toid or torev.

This parameter specifies the slots that are to be modified. Use totext-{slot}, tocontentmodel-{slot}, and tocontentformat-{slot} to specify content for each slot.

Text of the specified slot. If omitted, the slot is removed from the revision.

When totext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by totitle, toid or torev as if for a section edit.

Content serialization format of totext-{slot}.

Модель содержимого totext-{slot}. Если не задана, будет угадана по другим параметрам.

Выполнить преобразование перед записью правки (PST) над totext.

Укажите toslots=main и используйте totext-main.

Укажите toslots=main и используйте tocontentformat-main.

Укажите toslots=main и используйте tocontentmodel-main.

Использовать только указанную секцию из содержимого «to».

Какую информацию получить.

diff

HTML-код разницы.

diffsize

Размер HTML-кода разницы в байтах.

rel

Идентификаторы предыдущей к «from» и следующей за «to» версий.

ids

Идентификаторы страниц и версий «from» и «to».

title

Названия страниц для версий «from» и «to».

user

Имя и идентификатор участника для версий «from» и «to». Если версия пользователя была удалена, будет возвращено свойство fromuserhidden или touserhidden.

comment

Описания правок для версий «from» и «to». Если версия комментария была удалена, будет возвращено свойство fromcommenthidden или tocommenthidden.

parsedcomment

Распарсенные описания правок для версий «from» и «to». Если версия комментария была удалена, будет возвращено свойство fromcommenthidden или tocommenthidden.

size

Размер версий «from» и «to».

timestamp

(описание отсутствует)

Return individual diffs for these slots, rather than one combined diff for all slots.

Использовать только эти аутентификационные запросы, с id, возвращённом из action=query&meta=authmanagerinfo с amirequestsfor=create, или из предыдущего ответа этого модуля.

Формат, используемый для возвращаемых сообщений.

Слить поля информации со всех аутентификационных запросов в один массив.

Сохранить состояние с предыдущей провалившейся попытки авторизации, если возможно.

Если запрос action=query&meta=authmanagerinfo возвращает true для hasprimarypreservedstate, то запросы, отмеченные как primary-required, должны быть пропущены. Если запрос возвращает непустое значение поля preservedusername, то это значение должно быть использовано в параметре username.

Вернуть ссылку для стороннего процесса аутентификации, должна быть абсолютной. Либо этот параметр, либо createcontinue, обязателен.

После получения ответа REDIRECT, вы, как правило, должны открыть в браузере или вэб-просмотрщике указанную в redirecttarget ссылку для продолжения стороннего процесса аутентификации. По завершению, сторонний сервис отошлёт браузеру или веб-просмотрщику эту ссылку. Вы должны извлечь все параметры из ссылки и отослать их в параметр createcontinue запроса к этому модулю.

Этот запрос — продолжение после предшествующего о