Довідка 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
Назва нового розділу, якщо використовується section=new.
- text
Вміст сторінки.
- summary
Опис редагування.
Якщо цей параметр не вказано або він порожній, опис редагування може бути створено автоматично.
Якщо використовується section=new і sectiontitle не надається, значення цього параметра використовується замість назви розділу, і опис редагування генерується автоматично.
Мітки змін, які слід застосувати до цієї версії.
- Значення (розділені через | або альтернативу):
- 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, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
Модель вмісту нового вмісту.
- Одне з наступних значень: Scribunto, css, javascript, json, proofread-index, proofread-page, sanitized-css, text, unknown, wikitext
- returnto
Page title. If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to the given page, instead of the page that was edited.
- Тип: назва сторінки
- Приймати сторінки, що не існують.
- returntoquery
URL query parameters (with leading ?). If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to a page with the given query parameters.
- За замовчуванням: (порожньо)
- returntoanchor
URL fragment (with leading #). If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to a page with the given fragment.
- За замовчуванням: (порожньо)
- token
Токен «csrf» отримано з action=query&meta=tokens
Токен завжди має надсилатися як останній параметр або хоча б після параметра text.
- Цей параметр є обов'язковим.
- captchaword
Відповідь на CAPTCHA
- captchaid
Ідентифікатор CAPTCHA з попереднього запиту
- Редагувати сторінку
- 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 [відкрити в пісочниці]