API:Edit/ja

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

ページを編集する
ページをaction=editで編集と作成ができます.

パラメータ

 * : 編集するページ
 * : 編集するセクション. トップのセクションに対しては0、新しいセクションに対して'new'を使う
 * : (バージョン1.19で追加) 新しいセクションを追加する場合にセクション名として使う. 省略した場合は替わりにsummaryで指定した内容が使われる
 * : 新しいページ(もしくはセクションの)内容
 * : 編集トークン
 * : 編集のコメント
 * を使うとき、これはセクションのタイトルのために使われます
 * : 設定されると、細部の編集としてマークする
 * : 設定されると、"Mark all my edits minor by default"とMy preferences(オプション)で有効にしていたとしても、細部の編集としてマークしない.
 * : 設定されると、botの編集としてマークする
 * : 最後のリビジョンのタイムスタンプで、編集の衝突を検知するために使われます. 衝突を無視するためには設定されてない状態にしておきます
 * : 設定されると、ページが削除されている間のエラー表示を抑制しページを再作成する
 * : 設定されると、ページが既に存在する場合にエラーをスローする
 * : 設定されると、ページが存在しない場合にエラーをスローする
 * : ページをウォッチリストに追加する
 * : ウォッチリストからページを削除する、もしくは"Automatically watch all pages I edit"のようにpreferenceで有効になっていたしても追加しない
 * : 以前のリクエストからのCAPTCHAのID
 * : CAPTCHAへの回答

例
注: この例では、簡潔性のためだけにすべてのパラメータはGETリクエストに渡されますが. しかしながらaction=editはPOSTリクエストを必要です; GET リクエストはエラーを引き起こします. リクエストのヘッダにContent-Typeとしてapplication/x-www-form-urlencodedをセットするのを忘れないようにしてください.

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

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

起こり得るエラー
通常のものに加えて以下のエラーがあります:
 * code: notitle
 * info: titleパラメータを設定しなけばなりません
 * code: notext
 * info: textパラメータを設定しなければなりません
 * code: notoken
 * info: tokenパラメータを設定しなければなりません
 * code: invalidsection
 * info: sectionパラメータは整数もしくは'new'に設定しなければなりません
 * code: protectedtitle
 * info: このタイトルは作ることができないように保護されています
 * code: cantcreate
 * info: 新しいページを作るパーミッションを持っていません
 * code: cantcreate-anon
 * info: 匿名ユーザは新しいページを作ることができません
 * code: articleexists
 * info: 作ろうとした記事は既に作れたものです
 * code: noimageredirect-anon
 * info: 匿名ユーザは画像のリダイレクトを作ることができません
 * code: noimageredirect
 * info: 画像のリダイレクトを作るパーミッションを持っていません
 * code: spamdetected
 * info: スパムのフラグメント(断片)が含まれているので、編集が拒否されました: ``wikitext ''
 * code: filtered
 * info: フィルタコールバック関数が編集を拒否しました
 * code: contenttoobig
 * info: あなたが提供した内容はbytesバイトの記事の制限を越えます
 * code: noedit-anon
 * info: 匿名ユーザはページを編集できません
 * code: noedit
 * info: ページを編集するパーミッションを持っていません.
 * code: pagedeleted
 * info: タイムスタンプを取得した後でページは削除されました
 * code: emptypage
 * info: 新しい、空のページを作ることは許可されてません
 * code: editconflict
 * info: 編集の衝突が検知されました