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
編集するページIDです。title とは同時に使用できません。
- 型: 整数
- section
節識別子です。先頭の節の場合は 0、新しい節の場合は newを指定します。
- sectiontitle
section=newを使っているときの新しい節の名前です。
- text
ページの本文。
- summary
編集の要約。
このパラメーターが提供されていないか空のときには、編集の要約が自動生成される場合があります。
section=newを使い、sectiontitleが提供されていないときには、このパラメーターの値は節名として利用され、編集の要約は自動生成されます。
この版に適用する変更タグ。
- 値 (| または別の文字列で区切る): AWB、DevScript、MassProtect、MassRevisionDelete、MassRollback、ProveIt、convenient-discussions、ページ複製ガジェットによる編集
- minor
この編集に細部の変更の印を付ける
- 型: 真偽値 (詳細)
- notminor
利用者設定で「すべての編集を既定で細部の編集とする」を指定してあっても、細部の編集とマークしません。
- 型: 真偽値 (詳細)
- bot
この編集をボットの編集としてマークする。
- 型: 真偽値 (詳細)
- baserevid
ID of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions. Self-conflicts cause the edit to fail unless basetimestamp is set.
- 型: 整数
- basetimestamp
編集前の版のタイムスタンプ。編集競合を検出するために使用されます。 action=query&prop=revisions&rvprop=timestamp で取得できます。自身の競合は無視されます。
- Type: timestamp (allowed formats)
- starttimestamp
編集作業を開始したときのタイムスタンプ。編集競合を検出するために使用されます。適切な値は curtimestamp を使用して編集作業を開始するとき (たとえば、編集するページの本文を読み込んだとき) に取得できます。
- Type: timestamp (allowed formats)
- recreate
その間に削除されたページに関するエラーを上書きします。
- 型: 真偽値 (詳細)
- createonly
すでにそのページが存在する場合は編集を行いません。
- 型: 真偽値 (詳細)
- nocreate
そのページが存在しない場合にエラーを返します。
- 型: 真偽値 (詳細)
- watch
- 廃止予定です。
そのページを現在の利用者のウォッチリストに追加します。
- 型: 真偽値 (詳細)
- unwatch
- 廃止予定です。
そのページを現在の利用者のウォッチリストから除去します。
- 型: 真偽値 (詳細)
- watchlist
無条件に現在の利用者のウォッチリストに追加または除去するか、個人設定を利用(ボット利用者に対しては無視されます)するかウォッチを変更しないか。
- 値 (次の値のいずれか1つ): nochange、preferences、unwatch、watch
- 既定: preferences
- watchlistexpiry
ウォッチリストの有効期限のタイムスタンプ。現在の有効期限を変更せずそのままにするには、このパラメーターを完全に省略します。
- Type: expiry (details)
- md5
The MD5 hash of the text parameter, or the prependtext and appendtext parameters concatenated. If set, the edit won't be done unless the hash is correct.
- prependtext
このテキストをページまたはセクションの先頭に追加します。text をオーバーライドします。
- appendtext
このテキストをページまたは節の末尾に追加します。textを上書きします。
新しい節を追加するにはこのパラメーターではなく section=newを使用してください。
- undo
この版を取り消します。text, prependtext および appendtext をオーバーライドします。
- 型: 整数
- 値の下限は必ず0以上です。
- undoafter
undo からこの版までのすべての版を取り消します。設定しない場合、ひとつの版のみ取り消されます。
- 型: 整数
- 値の下限は必ず0以上です。
- redirect
自動的に転送を解決します。
- 型: 真偽値 (詳細)
- contentformat
Content serialization format used for the input text.
- 値 (次の値のいずれか1つ): application/json、application/octet-stream、application/unknown、application/x-binary、text/css、text/javascript、text/plain、text/unknown、text/x-wiki、unknown/unknown
- contentmodel
新しいコンテンツのコンテンツモデル。
- 値 (次の値のいずれか1つ): GadgetDefinition、JsonSchema、MassMessageListContent、Scribunto、SecurePoll、css、javascript、json、sanitized-css、text、unknown、wikitext
- token
action=query&meta=tokens から取得した「csrf」トークン
このトークンは常に最後のパラメーターとして、または少なくとも text パラメーターより後に送信されるべきです。
- この変数は必須です。
- 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.
- 既定値: (空)
- captchaword
CAPTCHAに答える
- captchaid
以前のリクエストのCAPTCHA ID
- ページを編集
- 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 [サンドボックスで開く]