API:Rollback/ja

巻き戻し
巻き戻しは一人の利用者による直近の一連の編集を取り消す操作です. In other words, rollback keeps undoing revision after revision until it encounters one made by someone different. この機能は、画面上にある [ ] リンクと同一の機能です. 巻き戻しの版は細部の編集としてマークされます. 必要があれば、ロールバックの操作とロールバックされた編集の両方をBot編集だとマークして、デフォルトのSpecial:RecentChangesから隠すことができます.

トークン
巻き戻しを行うためには、巻き戻しトークンが必要です. MediaWiki 1.24 以上を使っているなら、巻き戻しトークンを取得するために action=query&meta=tokens&type=rollback を使用することができます.

MediaWiki 1.23 以前の場合は、以下の説明に従ってください:

他の多くのトークンと異なり、巻き戻しトークンは共通ではありません: ログインごとに異なるのみならず、ページ名や誰の編集を巻き戻すかによって異なります. 巻き戻しトークンは以下のようにして取得できます:

Permissions
Rollback requires both the  and the   right on the target page; currently, this means that OAuth consumers, bot passwords etc. require both the   and the   grant –   alone is not enough!

ページの巻き戻し
action=rollback でページの巻き戻しができます.

パラメーター
Note that only one of  or   are required, and they cannot be used together.



例
注: 以下の例では、わかりやすさのためだけに、パラメーターをGETで渡すような形で書いてあります. 実際には、action=rollback のリクエストはPOSTで投げる必要があります（GETだとエラーになります）.

Returned fields


ロールバックしてもページ内容が変わらない場合、新しい版が作られることはありません. この場合、 と は等しくなります.

起こりうるエラー
In addition to the usual stuff: