API:Edit - Undelete/ja

From MediaWiki.org

Jump to: navigation, search
Tools clipart.png このページは MediaWiki API ドキュメントの一部です。
Languages 言語: 

English  • 日本語
MediaWiki API
MediaWiki version: 1.12

Contents

[edit] トークン

リビジョンをリストアするためにlist=deletedrevsを通してundeleteトークンを取得する必要があります。このトークンはeditトークンと等しくすべてのページに対して同じですが、ログインするたびに変わります。

undeleteトークンを取得する

api.php ? action=query & list=deletedrevs & drstart=20070904235959 & drend=20070904000000 & drprop=revid|user|minor|len|token & drlimit=8
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <deletedrevs drstart="20070904142729" />
  </query-continue>
  <query>
    <deletedrevs>
      <page title="Main Page" ns="0" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904200804" revid="31" user="Catrope" minor="" len="" />
          <rev timestamp="20070904200753" revid="30" user="Catrope" minor="" len="" />
          <rev timestamp="20070904193501" revid="29" user="Catrope" minor="" len="568" />
          <rev timestamp="20070904193213" revid="28" user="Catrope" minor="" len="470" />
          <rev timestamp="20070904193103" revid="27" user="192.168.1.3" len="568" />
          <rev timestamp="20070904193048" revid="26" user="192.168.1.3" len="480" />
        </revisions>
      </page>
      <page title="User:Catrope" ns="2" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904143938" revid="24" user="Catrope" len="52" />
          <rev timestamp="20070904142758" revid="23" user="Catrope" len="37" />
        </revisions>
      </page>
    </deletedrevs>
  </query>
</api>

[edit] 削除されたリビジョンをリストアする

削除されたリビジョンはaction=undeleteでリストアできます

[edit] パラメータ

  • title: 復元したいページ。
  • token: 以前のリクエストで取得されたリクエスト。'+'を'%2B'にurlencodeすることに注意して下さい
  • reason: 復元する理由(オプション)。
  • timestamps: リストアするリビジョンのタイムスタンプのパイプで区切られた一覧(オプション)。デフォルトでは、すべてのリビジョンはリストアされます。
    • list=deletedrevsを通してこれらのタイムスタンプを取得できます

[edit] サンプルのリクエスト

Main Pageのリビジョンの最後の5件をリストアする

api.php ? action=undelete & title=Main%20Page & token=e4c475f13be7824135b4edbebf4140ff%2B\ & reason=Deleted%20by%20accident & timestamps=20070904200804|20070904200753|20070904193501|20070904193213|20070904193103
<?xml version="1.0" encoding="utf-8"?>
<api>
  <undelete
    title="Main Page"
    revisions="5"
    fileversions="0"
    reason="5 revision(s) restored: Deleted by accident"
  />
</api>

[edit] 起こり得るエラー

通常のものに加えて以下のものがあります:

  • code: notitle
    • info: titleパラメータを設定しなければなりません
  • code: notoken
    • info: tokenパラメータを設定しなければなりません
  • code: permissiondenied
    • info: 削除されたリビジョンをリストアするパーミッションがありません
      • 大抵のwikiでは、削除されたリビジョンの復元はsysopに制限されていますが、別のwikiの中にはさらに厳しいルールを課しているものがあります。
  • code: cantundelete
    • info: 復元できませんでした: リクエストされたリビジョンは存在しないか、既に復元されている可能性があります
Retrieved from "http://www.mediawiki.org/wiki/API:Edit_-_Undelete/ja"