Справка 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

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

Type: boolean (details)
notminor

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

Type: boolean (details)
bot

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

Type: boolean (details)
baserevid

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

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

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

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

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

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

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

Type: boolean (details)
createonly

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

Type: boolean (details)
nocreate

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

Type: boolean (details)
watch
Устарело.

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

Type: boolean (details)
unwatch
Устарело.

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

Type: boolean (details)
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

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

Type: boolean (details)
contentformat

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

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

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

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

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

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

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

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

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

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

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

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

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