Справка MediaWiki API
Это автоматически сгенерированная страница документации MediaWiki API.
Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- Этот модуль требует прав на чтение.
- Этот модуль требует прав на запись.
- Этот модуль принимает только POST-запросы.
- Источник: MediaWiki
- Лицензия: GPL-2.0-or-later
Создание и редактирование страниц.
- title
Название редактируемой страницы. Нельзя использовать одновременно с pageid.
- pageid
Идентификатор редактируемой страницы. Нельзя использовать одновременно с title.
- Тип: целочисленное значение
- section
Идентификатор раздела. 0 для начального раздела, new для нового раздела. В основном - положительное целое число, но может иметь также и нечисловое значение.
- sectiontitle
Заголовок нового раздела при использовании section=new.
- text
Содержимое страницы.
- summary
Описание изменений.
Когда этот параметр не указан или незаполнен, описание изменений может быть создано автоматически.
Также является заголовком раздела, когда используется section=new, а sectiontitle не задано.
Если оно не указано при использовании section=new и sectiontitle, вместо этого параметра используется значение заголовка раздела, тогда описание изменений генерируется автоматически.
Изменить метки записи в истории изменений.
- Значения (разделённые с помощью | или альтернативного разделителя):
- 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.
- Это обязательный параметр.
- Редактировать страницу.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [открыть в песочнице]
- Добавить магическое слово __NOTOC__ в начало страницы.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [открыть в песочнице]
- Отменить изменения с 13579 по 13585 с автоматическим описанием правки.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [открыть в песочнице]