Довідка API MediaWiki
Це автоматично генерована сторінка документації API MediaWiki.
Документація та приклади: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- Цей модуль вимагає прав на читання.
- Цей модуль вимагає прав на запис.
- Цей модуль приймає лише POST-запити.
- Джерело: MediaWiki
- Ліцензія: GPL-2.0-or-later
Створювати і редагувати сторінки.
- title
Назва сторінки для редагування. Не можна використати разом з pageid.
- pageid
ID-сторінки для редагування. Не можна використати разом з title.
- Тип: ціле число
- section
Номер розділу. 0 для вступного розділу, new для нового розділу.
- sectiontitle
Назва нового розділу.
- text
Вміст сторінки.
- summary
Опис редагування. Також заголовок розділу, коли section=new і коли sectiontitle не вказано.
- tags
Мітки змін, які слід застосувати до цієї версії.
- Значення (розділені через | або альтернативу):
- minor
Позначити це редагування як незначне.
- Тип: логічний (подробиці)
- notminor
Не позначати це редагування як незначне, навіть якщо стоїть налаштування користувача «Позначати всі зміни як незначні за замовчуванням».
- Тип: логічний (подробиці)
- bot
Позначити редагування як зроблене ботом.
- Тип: логічний (подробиці)
- baserevid
Ідентифікатор базової версії, використовується для виявлення конфліктів редагувань. Можна отримати через action=query&prop=revisions. Конфлікти з власними редагуваннями спричиняють невдачу редагування, якщо тільки не встановлено basetimestamp.
- Тип: ціле число
- basetimestamp
Мітка часу для основної версії, використовується для виявлення конфлікту редагувань. Може бути отримана через action=query&prop=revisions&rvprop=timestamp. Конфлікти з власними редагуваннями ігноруються.
- Тип: часова мітка (дозволені формати)
- starttimestamp
Мітка часу, з якого почався процес редагування, використовується для виявлення конфліктів редагувань. Відповідне значення можна отримати з допомогою curtimestamp на початку процесу редагування (напр., коли завантажується вміст сторінки для редагування).
- Тип: часова мітка (дозволені формати)
- recreate
Відкинути будь-які помилки щодо цієї сторінки, вилучені нещодавно.
- Тип: логічний (подробиці)
- createonly
Не редагувати сторінку, якщо вона вже існує.
- Тип: логічний (подробиці)
- nocreate
Видати помилку, якщо сторінка не існує.
- Тип: логічний (подробиці)
- watch
- Застарілий.
Додати сторінку у список спостереження поточного користувача.
- Тип: логічний (подробиці)
- unwatch
- Застарілий.
Вилучити сторінку зі списку спостереження поточного користувача.
- Тип: логічний (подробиці)
- watchlist
Беззастережно додати або вилучити сторінку зі списку спостереження поточного користувача, використати налаштування або не змінювати спостереження.
- Одне з наступних значень: nochange, preferences, unwatch, watch
- Стандартно: preferences
- md5
MD5-хеш у параметрі text або параметрах prependtext і appendtext разом. Якщо вказано, редагування буде зроблене, лише якщо хеш правильний.
- prependtext
Додати цей текст на початок сторінки. Замінює text.
- appendtext
Додати цей текст у кінець сторінки. Замінює text.
Щоб додати новий розділ, замість цього параметра використайте section=new.
- undo
Скасувати цю версію. Замінює text, prependtext та appendtext.
- Тип: ціле число
- Значення має бути не меншим, ніж 0.
- undoafter
Скасувати усі версії від undo до цієї. Якщо не вказано, просто скасувати одну версію.
- Тип: ціле число
- Значення має бути не меншим, ніж 0.
- redirect
Автоматично виправляти перенаправлення.
- Тип: логічний (подробиці)
- contentformat
Формат серіалізації вмісту, використовуваний для введеного тексту.
- Одне з наступних значень: application/json, text/css, text/javascript, text/plain, text/x-wiki
- contentmodel
Модель вмісту нового вмісту.
- Одне з наступних значень: GadgetDefinition, Scribunto, css, javascript, json, sanitized-css, text, wikitext
- token
Токен «csrf» отримано з action=query&meta=tokens
Токен завжди має надсилатися як останній параметр або хоча б після параметра text.
- Цей параметр є обов'язковим.
- Редагувати сторінку
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [відкрити в пісочниці]
- Додати зміст на початок сторінки
- 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 [відкрити в пісочниці]