API:Edit/ru

From MediaWiki.org
Jump to navigation Jump to search
Другие языки:Project:Language policy English  • Deutsch • español • français • 日本語 • русский • Tiếng Việt • 中文
Эта страница является частью документации по MediaWiki action API.

API действий MediaWiki

v · d · e

Для использования этой функции должны быть установлены как true следующие настройки конфигурации: $wgEnableAPI и $wgEnableWriteAPI. Смотрите также: Manual:DefaultSettings.php.

Токен[edit]

Чтобы отредактировать страницу, необходим токен. Токен, в данном случае, одинаков для всех страниц, но меняется при следующем входе в систему. Если Вы хотите предотвратить конфликты редактирования (рекомендуется), Вы должны также указать метку времени последней версии страницы. Их можно получить следующим образом: Получить токен редактирования

Как редактировать страницы[edit]

Страницы можно редактировать и создавать с помощью action=edit.

Параметры[edit]

  • title: Редактируемая страница
  • section: Редактируемый раздел страницы. Используйте 0 для получения части до первого заголовка и 'new' для создания нового раздела
  • text: Новое содержание страницы или раздела
  • token: Токен редактирования
  • summary: Описание правки
    • Если вы используете section=new, текст, указанный в данном параметре, будет также применён для заголовка нового раздела
  • minor: Правка будет помечена как малая
  • notminor: Правка не будет помечена, даже если в настройках был установлен параметр "Всегда помечать подобные правки как малые"
  • bot: Пометить правку как правку бота; даже если Вы используете аккаунт бота, правка не будет помечена как совершённая ботом, если данный флаг не установлен
  • basetimestamp: Метка времени последней версии; если данный параметр не установлен, конфликты редактирования будут игнорироваться
  • starttimestamp: Метка времени, которая содержит дату получения токена редактирования; Также применяется для проверки на наличие конфликтов редактирования; если данный параметр не установлен, конфликты редактирования будут игнорироваться
  • recreate: Не возвращать ошибки, если страница была удалена в процессе работы, а просто создать страницу заново
  • createonly: Возвращать ошибку, если страница уже существует
  • nocreate: Возвращать ошибку, если страница не существует
  • watchlist: Получить значение параметра наблюдения: „watch“, „unwatch“, „preference“ или „nochange“:
    • watch: Добавить страницу в список наблюдения
    • unwatch: Удалить страницу из списка наблюдения
    • preferences: Следовать согласно пользовательским настройкам („Автоматически добавлять в список наблюдения даже отредактированные и созданные страницы“) (это - сстандартное значение)
    • nochange: не изменять список наблюдения
  • md5: Хеш-сумма параметра text. Если данный параметр установлен и хэш-суммы прежней и новой версии не совпадают, правка не будет выполнена. Таким образом можно избежать искажения данных.
  • captchaid: CAPTCHA-ID предыдущего запроса
  • captchaword: Ответ на CAPTCHA
  • undo: ID версий, к которым произойдёт откат правок. Параметры text, prependtext и appendtext будут игнорироваться.
  • undoafter: Откатить все версии, начиная с undo до текущей, но не откатывая её. Если этот параметр не установлен, будет откачена только одна версия.

Пример использования[edit]

Примечание: В данном примере все параметры передаются при помощи GET-запроса для простоты объяснения. Однако для action=edit требуются POST-запросы. GET-запросы выдадут ошибку. Не забудьте, что строка Content-Type должна содержать application/x-www-form-urlencoded Добавить новый раздел на страницу en:Talk:Main Page