API:Rollback/ja

ロールバック
ページをロールバックすることとは一人のユーザによる編集の一連の最後をundoすることを意味します. 言い換えると、 ロールバックは誰かに違うように変更されたリビジョンに遭遇するまでリビジョンの後のリビジョンをundoすることを続けます.

この機能はグラフィカルインターフェイスの[rollback ]によって提供されたものに対して理想的です.

ロールバックのリビジョンはは細部の編集としてマークされます. オプションとして、ロールバックとロールバックされる編集の両方はbotの編集としてマークでき、デフォルトでSpecial:Recentchangesからそれらを隠すことができます.

トークン
ページをロールバックするために、rollbackトークンが必要です. 他の多くのトークンとは異なり、rollbackトークンはユニバーサルではありません: それらはすべてのログインに対してのみ異なりませんが、ページのタイトルと編集がロールバックされたユーザの名前にも依存します. rollbackトークンは次のように取得できます:

ページをロールバックする
ページをaction=rollbackでロールバックできます.

パラメータ

 * title: ロールバックしたいページ.
 * token: 以前のリクエストで取得されたトークン. '+'を'%2B'にurlencodeすることに注意して下さい
 * user: 最後のリビジョンの著者.
 * summary: 編集の要約(オプション). 設定されていない場合、デフォルトの要約が使われます.
 * markbot: 設定されていない場合、ロールバックとロールバックされるリビジョンの両方はbotの編集としてマークされます.

返されるフィールド
ロールバックがページを変更しない場合、新しいリビジョンは作られません. この場合、revidはord_revidと等しくなります.
 * revid: ロールバックのリビジョンID.
 * old_revid: ロールバックされた最初の(最新の)リビジョンのリビジョンID.
 * last_revid: ロールバックされた最後の(最も古い)リビジョンのリビジョンID.

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


 * code: notitle
 * info: titleパラメータを設定しなければなりません
 * code: nouser
 * info: userパラメータを設定しなければなりません
 * code: notoken
 * info: tokenパラメータを設定しなければなりません
 * code: alreadyrolled
 * info: ロールバックを使用とするページは既にロールバックされていました
 * code: onlyauthor
 * info: ロールバックしようとしたページは筆者が1人しかいません