API:Edit - Protect/ja

このページは MediaWiki API ドキュメントの一部です。

MediaWiki API

• フォーマット
• エラーの報告
• ログイン
• クエリ
  • メタ情報
  • プロパティ
  • 一覧
• テンプレートを拡張しレンダリングする
• 編集する
  • ページを作成する/編集する
  • ページを移動する
  • ロールバック
  • ページを削除する
  • 削除されたリビジョンをリストアする
  • ページを保護/保護解除する
  • ユーザをブロック/ブロック解除する
• 内部で使う
• その他
• 実装
• クライアントコード

MediaWiki version:

1.12

トークン

ページの保護レベルを変更するために、protectトークンが必要です。このトークンはeditトークンと等しくすべてのページに対して同じですが、ログインするごとに変わります。protectトークンは次のように取得できます: protectトークンを取得する

api.php ? action=query & prop=info & intoken=protect & titles=Main%20Page

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page
        pageid="1"
      counter="20"
        length="470"
        protecttoken="58b54e0bab4a1d3fd3f7653af38e75cb+\" 
      />
    </pages>
  </query>
</api>

ページを保護する

ページをaction=protextで保護できます。

パラメータ

• title: 保護したいページ。
• token: 以前のリクエストで取得されたトークン。'+'を'%2B'にurlencodeすることに注意して下さい。
• protections: action=group、例えばedit=autoconfirmed|move=sysopなどとしてフォーマットされた保護のパイプで区切られた一覧表
  • 保護を取り除きたいのであれば、グループとしてallを使います。例えばedit=all|move=sysopです。
  • アクションを除外する場合、関連した値は変わりません。すなわちedit=sysopはmove protectionをそのままにします。
• expiry: GNUタイムスタンプ形式の期限のタイムスタンプ。'infinite'、'indefinite、'never'、もしくはまったく設定されない場合、保護は期限切れにならなくなります。'next Monday 16:04:57'もしくは'9:28 PM tomorrow'のようなタイムスタンプも許可されます。
• reason: 保護(保護解除)の理由(オプション)。
• cascade: 設定されると、保護されたページにトランスクルードされるページも保護されます。編集するために必要なユーザレベルは保護するために必要なユーザレベルよりも低く(例えばedit=autoconfirmed)、cascadingは有効にできず、このパラメータは暗黙のうちに無視されます。
  • これはページを保護することができない人々がcascading保護を持つページでそれらをトランスクルードすることでそれらを保護することをできないようにするということです。

サンプルのリクエスト

Main Pageを編集する。 渡すパラメータはedit=autoconfirmed、move=sysopで期限はOctober 24, 2007 at 16:07:54。cascading保護を有効にする。

api.php ? action=protect & title=Main%20Page & token=58b54e0bab4a1d3fd3f7653af38e75cb%2B\ & protections=edit=autoconfirmed|move=sysop & expiry=20071024160754 & cascade

<?xml version="1.0" encoding="utf-8"?>
<api>
  <protect title="Main Page" reason="" expiry="24-10-2007T16:07:54Z" cascade="">
      <protections edit="autoconfirmed" move="sysop" />
  </protect>
</api>

"Deletion log"を保護する。パラメータはcreate=sysopで、期限は今から2ヶ月

api.php ? action=protect & title=Deletion%20log & token=58b54e0bab4a1d3fd3f7653af38e75cb%2B\ & protections=create=sysop & expiry=2%20months & reason=Don't%20create%20this%20for%20now

<?xml version="1.0" encoding="utf-8"?>
<api>
  <protect title="Deletion log" reason="Don't create this for now" expiry="2008-03-08T16:34:30Z">
    <protections create="sysop" />
  </protect>
</api>

起こり得るエラー

通常のものに加えて、次のものがあります:

• code: notitle
  • info: titleパラメータを設定しなけれればなりません
• code: notoken
  • info: tokenパラメータを設定しなければなりません
• code: noprotections
  • info: protectionsパラメータを設定しなければなりません
• code: invalidexpiry
  • info: 無効な有効時間
    • 有効なタイムスタンプが無効な形でフォーマットされたもしくは存在しないことを意味します(例えばNovember 31もしくは24:05)。
• code: pastexpiry
  • info: 有効時間は過ぎました
• code: cantedit
  • info: このページを編集できないので保護できません
• code: create-titleexists
  • info: 既存のタイトルは'create'で保護できません
• code: missingtitle-createonly
  • info: 見つからないタイトルは'create'でのみ保護できます