API:Edit/ja

Requires the selected MediaWiki to have the following configuration settings set to :   and. See Manual:DefaultSettings.php. This module is implemented by ApiEditPage.php.

トークン
ページを編集するために、編集トークンが必要です. このトークンはすべてのページに対して同じですが、ログインごとに変わります. 編集トークンは、MediaWiki 1.20 以降では actions=tokens を使用して取得できます. また、以下の方法でも編集トークンを取得できます. 編集の衝突から保護するために(賢明なことです)、最後のリビジョンのタイムスタンプを取得することも必要です. これらの値を以下の例のように取得します:

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.

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

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

パラメーター

 * Some of these parameters seem to be revised in v1.20; for the current list, see ApiEditPage::getAllowedParams. To see the parameter list currently in use at Wikipedia, see: ApiEx/ja


 * : 編集したいページのページ名.  とは同時に指定できません.
 * 注:  を false に設定している場合は、「Article」と「article」は同一のページとは見なされません. これは例えばウィクショナリーと同様です.
 * : 編集したいページのページID.  とは同時に指定できません.
 * : Section number. 0 for the top section, 'new' for a new section. Omit to act on the entire page
 * : 新しいセクションを追加する場合にセクション名として使う. 省略した場合は代わりにsummaryで指定した内容が使われる.
 * : 新しいページ(またはセクション)の内容
 * : 編集トークン. Especially if you are not using the  parameter, the token should be sent as the last parameter, or at least, after the text parameter, to prevent a bad edit from getting committed if transmission of the body is interrupted for some reason.このパラメーターは必須です.
 * : 編集の要約. Also section title when section=new and sectiontitle is not set
 * : 設定されると、細部の編集としてマークする.
 * : 設定されると、"Mark all my edits minor by default"とMy preferences(オプション)で有効にしていたとしても、細部の編集としてマークしない.
 * : 設定すると、ボットの編集としてマークする. もしボットアカウントを使用していても、このフラグを立てないとボットの編集としてマークされない.
 * : Timestamp of the base revision (obtained through prop=revisions&rvprop=timestamp). Used to detect edit conflicts; leave unset to ignore conflicts
 * : Timestamp when you started editing the page (e.g., when you fetched the current revision's text to begin editing it or checked the (non-)existence of the page). 編集競合の検出に使用されます. 競合を無視するには設定されていない状態にしておきます
 * : Override any errors about the article having been deleted in the meantime
 * : Don't edit the page if it exists already
 * : Throw an error if the page doesn't exist
 * : Add the page to your watchlist. Deprecated. Use the watchlist argument
 * : Remove the page from your watchlist. Deprecated. Use the watchlist argument
 * : Specify how the watchlist is affected by this edit, set to one of "watch", "unwatch", "preferences", "nochange":
 * : ページをウォッチリストに追加する
 * : ウォッチリストからページを削除する
 * : use the preference settings (Default)
 * : don't change the watchlist
 * : MD5 hash (hex) of the  parameter or the   and   parameters concatenated. If this parameter is set and the hashes don't match, the edit is rejected. This can be used to guard against data corruption
 * : Add this text to the beginning of the page. Overrides text
 * : Add this text to the end of the page. Overrides text. Use section=new to append a new section
 * : Revision ID to undo. Overrides,   and
 * : Undo all revisions from  up to but not including this one. If not set, just undo one revision
 * : Automatically resolve redirects
 * : Content serialization format used for the input text
 * ウィキテキスト
 * JavaScript
 * CSS
 * プレーンテキスト
 * JSON
 * : Content model of the new content
 * : CAPTCHA ID from the previous request
 * : CAPTCHA に対する回答
 * : CAPTCHA ID from the previous request
 * : CAPTCHA に対する回答
 * : CAPTCHA ID from the previous request
 * : CAPTCHA に対する回答
 * : CAPTCHA ID from the previous request
 * : CAPTCHA に対する回答
 * : CAPTCHA に対する回答

, this needs to be urlencoded (so it will end with ) before it is passed back.

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:

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 http://en.wikipedia.org/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--