Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=edit

(main | edit)
  • Этот модуль требует прав на чтение.
  • Этот модуль требует прав на запись.
  • Этот модуль принимает только POST-запросы.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0-or-later

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

Определённые параметры:
Other general parameters are available.
title

Название редактируемой страницы. Нельзя использовать одновременно с pageid.

pageid

Идентификатор редактируемой страницы. Нельзя использовать одновременно с title.

Тип: целочисленное значение
section

Идентификатор раздела. 0 для начального раздела, new для нового раздела. В основном - положительное целое число, но может иметь также и нечисловое значение.

sectiontitle

Заголовок нового раздела при использовании section=new.

text

Содержимое страницы.

summary

Описание изменений.

Когда этот параметр не указан или незаполнен, описание изменений может быть создано автоматически.

Также является заголовком раздела, когда используется section=new, а sectiontitle не задано.

Если оно не указано при использовании section=new и sectiontitle, вместо этого параметра используется значение заголовка раздела, тогда описание изменений генерируется автоматически.

tags

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

Значения (разделённые с помощью | или альтернативного разделителя):
minor

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

Тип: булева (подробнее)
notminor

Не помечать эту правку как малое изменение даже если установлена пользовательская настройка «По умолчанию помечать все правки как малые».

Тип: булева (подробнее)
bot

Пометить правку как сделанную ботом.

Тип: булева (подробнее)
baserevid

Идентификатор предыдущей версии, используемый для обнаружения конфликтов редактирования. Может быть получено через action=query&prop=revisions. Самостоятельные конфликты приводят к сбою редактирования, если не задана базовая отметка времени.

Тип: целочисленное значение
basetimestamp

Метка времени редактируемой версии, используется для обнаружения конфликтов редактирования. Может быть получена посредством action=query&prop=revisions&rvprop=timestamp. Конфликты с самими собой игнорируются.

Тип: временная метка (разрешённые форматы)
starttimestamp

Метка времени начала редактирования, используется для обнаружения конфликтов редактирования. Необходимое значение может быть получено с помощью curtimestamp в начале редактирования (то есть, после загрузки содержимого редактируемой страницы).

Тип: временная метка (разрешённые форматы)
recreate

Игнорировать предупреждение о том, что страница была удалена во время редактирования.

Тип: булева (подробнее)
createonly

Не редактировать страницу, если она уже существует.

Тип: булева (подробнее)
nocreate

Выбрасывать ошибку, если страницы не существует.

Тип: булева (подробнее)
watch
Устарело.

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

Тип: булева (подробнее)
unwatch
Устарело.

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

Тип: булева (подробнее)
watchlist

Безусловно добавить или удалить страницу из списка наблюдения текущего участника, использовать настройки (игнорируются для пользователей-ботов) или не менять наблюдение.

Одно из следующих значений: nochange, preferences, unwatch, watch
По умолчанию: preferences
md5

MD5-хэш параметра text, или конкатенации параметров prependtext и apendtext. Если задан, правка не будет выполнена при несовпадении хэша.

prependtext

Добавить этот текст в начало страницы или раздела. Переопределяет text.

appendtext

Добавить этот текст в конец страницы или раздела. Переопределяет $text.

Для создания нового раздела, используйте section=new, а не этот параметр.

undo

Отменить это изменение. Переопределяет $text, prependtext и appendtext.

Тип: целочисленное значение
Значение должно быть не меньше 0.
undoafter

Отменить все изменения от undo до данного. Если не задано, просто отменить одно изменение.

Тип: целочисленное значение
Значение должно быть не меньше 0.
redirect

Автоматически разрешать перенаправления.

Тип: булева (подробнее)
contentformat

Формат сериализации содержимого, используемый для введённого текста.

Одно из следующих значений: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
contentmodel

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

Одно из следующих значений: GadgetDefinition, css, javascript, json, sanitized-css, text, unknown, vue, wikitext
token

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

Токен всегда должен быть послан в качестве последнего параметра, или, по крайней мере, после параметра text.

Это обязательный параметр.
returnto

Заголовок страницы. Если при сохранении правки была создана временная учётная запись, то API может выдать в ответ URL, который клиент должен посетить для завершения входа в систему. Если этот параметр указан, то URL будет перенаправлен на данную страницу, а не на страницу, которая была отредактирована.

Тип: название страницы
Принимает несуществующие страницы.
returntoquery

Параметры запроса URL (с ведущими ?). Если при сохранении правки была создана временная учётная запись, то в ответ на запрос API может быть указан URL, который клиент должен посетить для завершения входа в систему. Если этот параметр указан, то URL будет перенаправлен на страницу с заданными параметрами запроса.

По умолчанию: (пусто)
returntoanchor

Фрагмент URL (с ведущим #). Если при сохранении правки была создана временная учётная запись, то API может ответить на запрос URL, который клиент должен посетить для завершения входа в систему. Если этот параметр указан, то URL будет перенаправлен на страницу с указанным фрагментом.

По умолчанию: (пусто)
captchaword

Ответ на капчу

captchaid

CAPTCHA ID из предыдущего запроса

discussiontoolsautosubscribe

Automatically subscribe the user to any new talk page threads created by the edit. Use 'yes' or 'no' to override a user's preference (the default).

Одно из следующих значений: no, preferences, yes
По умолчанию: preferences