API:Edit/ja

This module is implemented by ApiEditPage.php.

トークン
ページを編集するために、編集トークンが必要です. このトークンはすべてのページに対して同じですが、ログインするたびに変わります. The preferred method to obtain an edit token depends on the MediaWiki version: Currently, all older methods continue to work, but are deprecated.
 * Versions 1.24 and later: action=query&meta=tokens
 * Versions 1.20-1.23: action=tokens
 * Versions 1.19 and earlier: action=query&prop=info

If you want to protect against edit conflicts (which is wise), you also need to get the timestamp of the last revision, included in the example below:

When passing this to the Edit API, always pass the token parameter last (or at least after the text parameter). That way, if the edit gets interrupted, the token won't be passed and the edit will fail. This is done automatically by mw.Api.

When running on a MediaWiki page, the token can be obtained by calling  (more information).

Unregistered users
For unregistered users, the token is always, but you may want to request it explicitly in case this changes in the future.

ページの編集
で、ページの編集や作成ができます.

パラメーター

 * : 編集したいページのページID.  とは同時に指定できません.
 * : 新しいセクションを追加する場合にセクション名として使う. 省略した場合は代わりにsummaryで指定した内容が使われる.
 * : 新しいページ(またはセクション)の内容
 * : 編集の要約. Also section title when section=new and sectiontitle is not set
 * : 設定されると、細部の編集としてマークする.
 * : 設定されると、"Mark all my edits minor by default"とMy preferences(個人設定)で有効にしていたとしても、細部の編集としてマークしない.
 * : 設定すると、ボットの編集としてマークする. もしボットアカウントを使用していても、このフラグを立てないとボットの編集としてマークされない.
 * : ページをウォッチリストに追加する
 * : ウォッチリストからページを削除する
 * : ウォッチリストを変更しない
 * : リダイレクトを自動的に解決する
 * : ページをウォッチリストに追加する
 * : ウォッチリストからページを削除する
 * : ウォッチリストを変更しない
 * : リダイレクトを自動的に解決する
 * : ページをウォッチリストに追加する
 * : ウォッチリストからページを削除する
 * : ウォッチリストを変更しない
 * : リダイレクトを自動的に解決する
 * : ウォッチリストを変更しない
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する
 * : リダイレクトを自動的に解決する

例
注: この例では、簡潔性のためだけにすべてのパラメーターはGETリクエストに渡されますが、しかしながらaction=editはPOSTリクエストを必要とします; GET リクエストはエラーを引き起こします. リクエストのヘッダーにContent-Typeとしてapplication/x-www-form-urlencodedをセットするのを忘れないようにしてください. あなたが受け取るトークンは ,で終了します. これはリクエストを送信する前に urlエンコードされなければなりません (つまりそれは  で終了します).

CAPTCHAと拡張機能のエラー
編集がCAPTCHAを必要な場合、次のようなエラーが表示されます: The specific information you get will depend on the captcha in use. 大抵の場合、you won't get a math 数学のCAPTCHAを得られず、( フィールドの)画像へのURLになります. CAPTCHAを解決したとき、リクエストを再試行してください (この場合は で).

Other extensions that use the APIEditBeforeSaveフックを使う別のフックは通常のエラーフォーマットで説明されたどちらかのフォーマットを使うと failure results を返すことがあります.

起こり得るエラー
通常のものに加えて以下のエラーがあります:

Editing via Ajax
Below is sample code for editing a page via an Ajax request: You can also use the mw.Api object: Remember to make sure the  module is loaded when using this methodology.

Editing via Python

 * /Editing with Python

Large texts
When using texts over 8000 characters, use "multipart/form-data" as it does not require escaping and will be significantly smaller than its urlencoded counterpart. Multipart has roughly 160 bytes of overhead for each parameter, so for seven parameters that's ~1.1kb overhead. Example: POST /w/api.php HTTP/1.1 User-Agent: Bot Framework Content-Type: multipart/form-data; boundary=---8ce61ec834cf268 Host: en.wikipedia.org Cookie: Content-Length: 1348 Accept-Encoding: gzip Connection: Keep-Alive

-8ce61ec834cf268 Content-Disposition: form-data; name="action"

edit -8ce61ec834cf268 Content-Disposition: form-data; name="title" Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit

Title here -8ce61ec834cf268 Content-Disposition: form-data; name="text" Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit

Text here -8ce61ec834cf268 Content-Disposition: form-data; name="summary" Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit

Summary -8ce61ec834cf268 Content-Disposition: form-data; name="token"

1f287ba00a908e9622045e7b18ffa352+\ -8ce61ec834cf268 Content-Disposition: form-data; name="assert"

user -8ce61ec834cf268 Content-Disposition: form-data; name="format"

xml -8ce61ec834cf268--