API:Lists/ja

From MediaWiki.org
< API:Lists(Redirected from API:Query - Lists/ja)
Jump to: navigation, search
Tools clipart.png このページは MediaWiki API ドキュメントの一部です。
言語: English  • Deutsch • Español • 日本語 • Українська
MediaWiki API

リストは2つの面でプロパティから異なります - データをpagesの要素に追加する代わりに、それぞれのリストはquery要素で独自の分離したブランチを持ちます。また、リストの出力はアイテム数によって制限され、the query-continue要素を使って持続されることがあります。Unless indicated otherwise, このページにリスト表示されたすべてのモジュールはジェネレータとして使われます。

Contents

[edit] allpages / ap

MediaWiki version: 1.9

ページのタイトル順で、任意の名前空間のページの一覧を返します。

[edit] パラメータ

  • apfrom: このタイトルで一覧表示を始めます。The title need not exist
  • apprefix: この値で始まるタイトルのみを一覧表示する
  • apnamespace: エミュレートする名前空間。一度に1つの名前空間のみをエミュレートできます。デフォルトでは、mainの名前空間がエミュレートされます
  • apfilterredir: リダイレクトをフィルタする方法
    • all: リダイレクトのフラグに関わらずすべてのページを一覧表示する (default)
    • redirects: リダイレクトのみを一覧表示する
    • nonredirects: リダイレクトを一覧表示しない
  • apfilterlanglinks: ページが言語リンクを持っているかに基づいてフィルタする方法
    • all: ページが言語リンクを含むかに関わらずすべてのページを一覧表示する (default)
    • withlanglinks: 言語リンクを持ったページのみを一覧表示する
    • withoutlanglinks: 言語リンク無しでページを一覧表示する
  • apminsize: 最小のバイト単位でこの大きさのページのみを一覧表示する
  • apmaxsize: 最大でバイト単位でこの大きさのページのみを一覧表示する
  • apprtype: このタイプのアクションから保護されたページの一覧のみを表示する
    • edit: edit-protectedページのみを一覧表示する
    • move: move-protectedページのみを一覧表示する
    • wikiの中はこの種の保護を許可していることがあり、ここよりも多くのオプションが提供されるものがあります
  • apprlevel: このレベルで保護されたページのみを一覧表示する。apprtype無しで利用できません。
    • autoconfirmed: 自動認証されたユーザーのみが編集/移動/何でもできます
    • sysop: sysopのみが編集/移動/何でもできます
    • Empty: 誰でも編集/移動/何でもできます
    • wikiの中にはより多くのレベルでの保護を許可しここよりも多くのオプションを提供するものもあります
  • aplimit: 一覧表示するページの最大量 (デフォルトで10)
  • apdir: 一覧表示するディレクションにて
    • ascending: AからZまでの一覧を表示する (default)
    • descending: ZからAまでの一覧を表示する

[edit]

"Kre"から始まる最初の5ページの一覧を表示する

<api>
  <query-continue>
    <allpages apfrom="Kreatel" />
  </query-continue>
  <query>
    <allpages>
      <p pageid="1756320" ns="0" title="Kre'fey" />
      <p pageid="3361042" ns="0" title="Kreab" />
      <p pageid="288613" ns="0" title="Kreacher" />
      <p pageid="812540" ns="0" title="Kreamer, PA" />
      <p pageid="133750" ns="0" title="Kreamer, Pennsylvania" />
    </allpages>
  </query>
</api>

[edit] 起こり得るエラー

  • code: apparams
    • info: allpagesをパラメータとして使うとき"redirects"の代わりに"gapfilterredir=nonredirects" オプションを使う
  • code: apparams
    • info: prlevelはprtype無しで使うことは許可されません

[edit] alllinks / al

MediaWiki version: 1.11

任意の名前空間で始まるページへのリンクの一覧をリンクのタイトル順で返す。

[edit] パラメータ

  • alfrom: このタイトルで一覧表の表示を始める。タイトルは存在する必要はない
  • alprefix: この値で始まるタイトルへのリンクのみを一覧表示する
  • alnamespace: エミュレートする名前空間。一度に1つの名前空間のみエミュレートできます。デフォルトでは、mainの名前空間がエミュレートされます
  • alunique: 設定される場合、同じタイトルへの複数のリンクが一度だけ一覧表示されます。ジェネレータモードでもしくはalprop=idsで使うことはできません。
  • allimit: 一覧表示するリンクの最大量(デフォルトで10)
  • alprop: 返すプロパティ
    • ids: リンクするページのページID。aluniqueと一緒に使うことはできません。
    • title: タイトルにリンクする (デフォルト)

[edit]

Talk:APIで始まる名前を持つtalkページへのすべてのリンクを一覧表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <alllinks alfrom="APILAS" />
  </query-continue>
  <query>
    <alllinks>
      <l fromid="3633229" ns="1" title="Talk:API" />
      <l fromid="14912955" ns="1" title="Talk:API-Calculus" />
      <l fromid="15131143" ns="1" title="Talk:API5" />
      <l fromid="15165243" ns="1" title="Talk:API5" />
      <l fromid="8327984" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14109257" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14177354" ns="1" title="Talk:APIIC Tower" />
      <l fromid="14180196" ns="1" title="Talk:APIIC Tower" />
      <l fromid="6760965" ns="1" title="Talk:APIIT" />
      <l fromid="12229053" ns="1" title="Talk:APILAS" />
    </alllinks>
  </query>
</api>

[edit] 起こり得るエラー

  • code: alparams
    • info: alllinksはunique linksモードでジェネレータとして使うことはできません
  • code: alparams
    • info: alllinksはunique linksモードで対応するページidを返すことができません
      • これはaluniquealprop=idsを一緒に使うとき起こります。

[edit] allcategories / ac

MediaWiki version: 1.12

すべてのカテゴリの一覧を取得する。list=allpages&alnamespace=14とは空のカテゴリが一覧表示されず、説明ページ無しのカテゴリが一覧表示されるという点で異なる。

[edit] パラメータ

  • acfrom: このカテゴリタイトルで一覧表示を始める。カテゴリは存在している必要はありません。
  • acprefix: この値で始まるカテゴリタイトルのみを一覧表示する
  • aclimit: 一覧表示するカテゴリの最大数(デフォルトで10)
  • acdir: 一覧表示する順序
    • ascending: AからZへ一覧表示する (default)
    • descending: ZからAへ一覧表示する

[edit]

"List of"で始まる名前を持つカテゴリの最初の10を一覧表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <allcategories acfrom="List of Baptist sub-denominations" />
  </query-continue>
  <query>
    <allcategories>
      <c>List of &quot;M&quot; series military vehicles</c>
      <c>List of Alternative Rock Groups</c>
      <c>List of Alumni of Philippine Science High School</c>
      <c>List of American artists</c>
      <c>List of Anglicans and Episcopalians</c>
      <c>List of Arizona Reptiles</c>
      <c>List of Artists by record label</c>
      <c>List of Australian Anglicans</c>
      <c>List of Bahá'ís</c>
      <c>List of Balliol College people</c>
    </allcategories>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] allusers / au

MediaWiki version: 1.11

ユーザー名で並び替えられた登録ユーザーの一覧を取得する。このモジュールは一覧として使うことはできません。

[edit] パラメータ

  • aufrom: このユーザー名で一覧表示を始める。ユーザー名は存在する必要はありません
  • auprefix: この値で始まるユーザー名のみを一覧表示する
  • augroup: このグループのユーザのみを一覧表示する
    • bot
    • sysop
    • bureaucrat
    • wiki上で定義された他のグループ。これはすべてのwikiで異なります; 可能な値の一覧に関してはAPIのヘルプもしくはaction=paraminfoをご覧下さい
  • auprop: どのプロパティを返すか
    • editcount: ユーザが行った編集回数
    • groups: ユーザが所属するすべてのグループの一覧
    • registration: ユーザ登録の日付と時間
  • aulimit: 一覧表示するユーザ数(デフォルトは10)

[edit]

最初の5人のsysopの一覧を表示する

<api>
  <query-continue>
    <allusers aufrom="A Train" />
  </query-continue>
  <query>
    <allusers>
      <u name="(aeropagitica)" />
      <u name="-- April" />
      <u name="17Drew" />
      <u name="23skidoo" />
      <u name="A Man In Black" />
    </allusers>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] allimages / ai

MediaWiki version: 1.12

画像のタイトル順で、すべての画像の一覧を返す。

[edit] パラメータ

  • aifrom: このタイトルで一覧表示を始める。タイトルは存在する必要はない
  • aiprefix: この値で始まるタイトルのみを一覧表示する
  • aiminsize: 最小でこのバイト数の画像のみを一覧表示する
  • aimaxsize: 最大でこのバイト数の画像のみを一覧表示する
  • ailimit: 一覧表示する画像の最大数(デフォルトは10)
  • aidir: 一覧表示するのはどのディレクションで
    • ascending: AからZを一覧表示する (デフォルト)
    • descending: ZからAを一覧表示する
  • aisha1: このSHA-1ハッシュを持つ画像のみを一覧表示する。これらのハッシュはユニークであることになっているので、重複を追跡するためにこれを使うことができます。同じハッシュを持つ2つの異なる画像に遭遇したら、

ロッテリー(宝くじ)を興じることを始めた方がいいでしょう

  • aisha1base36: aisha1と同じだが、base 36の点で異なる
  • aiprop: どのプロパティを取得するか
    • timestamp: 最新のバージョンの画像がアップロードされたときの時間と日付(デフォルト)
    • url: 最新のバージョンの画像のURL(デフォルト)
    • size: バイト単位の画像のサイズ
    • dimensions: ピクセル単位の画像の幅と高さ
    • mime: 画像のMIMEタイプ
    • sha1: 画像のSHA-1ハッシュ

[edit]

"Albert"で始まる名前を持つ画像の最初の5件の一覧を表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <allimages aifrom="Albert-einstein-biography-pictures.jpg" />
  </query-continue>
  <query>
    <allimages>
      <img name="Albert&#039;s_Real_Jamaican_Foods.JPG" width="1024" height="768" mime="image/jpeg" />
      <img name="Albert-Cashier.jpg" width="150" height="220" mime="image/jpeg" />
      <img name="Albert-Park-Brisbane-1.jpg" width="936" height="695" mime="image/jpeg" />
      <img name="Albert-Park-Brisbane-2.jpg" width="830" height="525" mime="image/jpeg" />
      <img name="Albert-Park-railway-station.jpg" width="640" height="480" mime="image/jpeg" />
    </allimages>
  </query>
</api>

[edit] 起こり得るエラー

  • code: aiparams
    • info: "redirects" when using allimagesをジェネレータとして使うときに"redirects"の代わりに"gaifilterredir=nonredirects"オプションを使う

[edit] backlinks / bl

MediaWiki version: 1.9

Special:Whatlinkshereと同じように任意のページにリンクするページをリンクしているページのタイトルの順番で一覧表示する。

[edit] パラメータ

  • bltitle: このタイトルにリンクするページを一覧表示する。タイトルは存在する必要はない
  • blnamespace: これらの名前空間のページのみを一覧表示する
  • blfilterredir: リダイレクトをフィルタする方法
    • all: リダイレクトフラグに関わらずすべてのページを一覧表示する (デフォルト)
    • redirects: リダイレクトのみを一覧表示する
    • nonredirects: リダイレクトを一覧表示しない
  • bllimit: 一覧表示するページの最大数(デフォルトは10)
  • blredirect: 設定されている場合、リダイレクトを通してbltitleにリンクするページも一覧表示される。詳細な情報に関しては下記を参照
  • blcontinue: 以前のリクエストを持続するために使われる

[edit]

en:Main Pageにリダイレクトするすべてのページを見つける

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <backlinks blcontinue="0|Main_Page|668228" />
  </query-continue>
  <query>
    <backlinks>
      <bl pageid="217224" ns="0" title="Mainpage" />
      <bl pageid="217225" ns="0" title="Main page" />
      <bl pageid="234094" ns="0" title="Main Path" />
      <bl pageid="485188" ns="4" title="Wikipedia:Main page" />
      <bl pageid="485697" ns="0" title="Main Page/" />
    </backlinks>
  </query>
</api>

[edit] リダイレクトを通したリンク

MediaWiki version: 1.12

blredirectパラメータが設定されているとき、このモジュールはわずかに異なった振る舞いをします。bllimitは両方のレベルに個別に適用します: 例えばbllimit=10の場合、最大で10のfirst-level のページ(bltitleにリンクするページ)と10のsecond-levelページ(リダイレクトを通してbltitleにリンクするページ)が一覧表示されます。クエリの持続も、次の例で示されるように、異なった動作をします。

Application programming interfaceにリンクするページの一覧を取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <backlinks blcontinue="0|Application_programming_interface|1191|42661" />
  </query-continue>
  <query>
    <backlinks>
      <bl pageid="1191" ns="0" title="API" redirect="">
        <redirlinks>
          <bl pageid="2807" ns="0" title="Active Directory" />
          <bl pageid="4355" ns="0" title="BBC Micro" />
          <bl pageid="8146" ns="0" title="DOS" />
          <bl pageid="9101" ns="0" title="Device driver" />
          <bl pageid="15215" ns="0" title="Internet Explorer" />
          <bl pageid="29090" ns="0" title="Software testing" />
          <bl pageid="30237" ns="0" title="Tcl" />
          <bl pageid="32612" ns="0" title="Virtual reality" />
          <bl pageid="34203" ns="0" title="XFS" />
          <bl pageid="37545" ns="0" title="Palm OS" />
        </redirlinks>
      </bl>
      <bl pageid="2141" ns="0" title="Atari ST" />
      <bl pageid="2323" ns="0" title="Amdahl&#039;s law" />
      <bl pageid="2581" ns="0" title="Apache HTTP Server" />
      <bl pageid="2753" ns="0" title="AutoCAD" />
      <bl pageid="3105" ns="0" title="AmigaOS" />
      <bl pageid="3130" ns="0" title="Advanced Power Management" />
      <bl pageid="4440" ns="0" title="Berkeley Software Distribution" />
      <bl pageid="4473" ns="0" title="BIOS" />
      <bl pageid="4706" ns="0" title="Berkeley DB" />
    </backlinks>
  </query>
</api>

このリクエストを持続するとき、APIにリンクするより多くのページが存在し、他のfirst-levelページが再び一覧表示されていることを見ます。Berkeley DBを乗り越えるために、APIのすべてのリンクが手に入る(もしくはもちろんbllimitを増やす)まで、query-continueを繰り返し持続しなければなりません。 以前のリクエストを持続する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <backlinks blcontinue="0|Application_programming_interface|1191|56891" />
  </query-continue>
  <query>
    <backlinks>
      <bl pageid="1191" ns="0" title="API" redirect="">
        <redirlinks>
          <bl pageid="42661" ns="0" title="Myth (computer game series)" />
          <bl pageid="42750" ns="0" title="Enterprise JavaBean" />
          <bl pageid="45308" ns="0" title="XPath" />
          <bl pageid="46628" ns="0" title="Automated teller machine" />
          <bl pageid="51172" ns="0" title="DNIX" />
          <bl pageid="51746" ns="0" title="Cisco Systems" />
          <bl pageid="53076" ns="0" title="Darwin (operating system)" />
          <bl pageid="53252" ns="0" title="Liberty BASIC" />
          <bl pageid="55519" ns="0" title="NeWS" />
          <bl pageid="55888" ns="0" title="Trusted system" />
        </redirlinks>
      </bl>
      <bl pageid="2141" ns="0" title="Atari ST" />
      <bl pageid="2323" ns="0" title="Amdahl&#039;s law" />
      <bl pageid="2581" ns="0" title="Apache HTTP Server" />
      <bl pageid="2753" ns="0" title="AutoCAD" />
      <bl pageid="3105" ns="0" title="AmigaOS" />
      <bl pageid="3130" ns="0" title="Advanced Power Management" />
      <bl pageid="4440" ns="0" title="Berkeley Software Distribution" />
      <bl pageid="4473" ns="0" title="BIOS" />
      <bl pageid="4706" ns="0" title="Berkeley DB" />
    </backlinks>
  </query>
</api>

[edit] 起こり得るエラー

  • code: blbad_title_count
    • info: backlinksクエリは始めるために1つのタイトルが必要です
      • これはbltitle(この使い方は非推奨)の代わりにtitlesを使い複数のタイトルを指定するときに行われます
  • code: bl_badcontinue
    • info: 無効な持続パラメータ。以前のクエリによって返されたオリジナルの値を渡すべきです

[edit] blocks / bk

MediaWiki version: 1.12

Special:Ipblocklist形式ですべてのブロックを表示する。このモジュールはジェネレータとして使うことができません。

[edit] パラメータ

  • bkstart: 一覧表示を始めるタイムスタンプ
  • bkend: 一覧表示を終わらせるタイムスタンプ
  • bkdir: 一覧表示するディレクション。
    • older: 最新のブロックを最初から一覧表示する(デフォルト)。 注: bkstartはbkendよりでなければなりません.
    • newer: 最も古いブロックを最初から一覧表示する。注: bkstart has to be before bkend.
  • bkids: これらのIDを持つブロックのみを一覧表示する
  • bkusers: これらのユーザのブロックのみを一覧表示する
  • bklimit: 一覧表示するブロックの最大数(デフォルトで10)
  • bkprop: パイプで区切られた取得するプロパティ。デフォルトの値はid|user|by|timestamp|expiry|reason|flags
    • id: ブロックのID(デフォルト)
    • user: ブロックされたIPアドレスもしくはユーザ名(デフォルト)
    • by: ブロックが適用されたユーザ(デフォルト)
    • timestamp: ブロックが提供されたとき(デフォルト)
    • expiry: ブロックが期限切れになるとき(デフォルト)
    • reason: ブロックの理由(デフォルト)
    • range: IPのレンジがブロックされた場合、適用される最初と最後のIP
    • flags: ブロックに適用するフラッグ(デフォルト)
      • automatic: autoblockのため自動的にブロックされた (action=blockも参照)
      • anononly: 匿名ユーザのみブロックされる
      • nocreate: アカウント作成が無効
      • autoblock: このブロックのために自動的なブロッキングが有効
      • noemail: wikiを通して電子メールを送ることがブロックされたユーザに対して無効
      • hidden: このブロックがSpecial:Ipblocklistから隠される。oversightパーミッションを持つユーザのみこれらのブロックを見ることができる。

[edit]

最新のブロックを3件一覧表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <blocks>
      <block id="4"
        user="123.123.0.0/16"
        userid="0"
        by="Catrope"
        byuserid="1"
        timestamp="2007-11-23T11:44:41Z"
        expiry="infinity"
        reason="Bad proxies; these folks will just have to register"
        rangestart="123.123.0.0"
        rangeend="123.123.255.255"
        anononly=""
      />
      <block
        id="2"
        user="25.50.100.200"
        userid="0"
        by="Catrope"
        byuserid="1"
        timestamp="2007-11-23T11:37:28Z"
        expiry="infinity"
        reason="Intimidating behaviour/harassment"
        rangestart="25.50.100.200"
        rangeend="25.50.100.200"
        anononly=""
        nocreate=""
      />
      <block
        id="1"
        user="Vandal01"
        userid="3"
        by="Catrope"
        byuserid="1"
        timestamp="2007-11-23T11:36:40Z"
        expiry="2007-12-23T11:36:40Z"
        reason="Spamming links to external sites"
        rangestart="0.0.0.0"
        rangeend="0.0.0.0"
        nocreate=""
        autoblock=""
        noemail=""
      />
    </blocks>
  </query>
</api>

[edit] 起こり得るエラー

無し。

[edit] categorymembers / cm

MediaWiki version: 1.11

任意のカテゴリに所属するページの一覧をページのタイトルをソートした順番で表示する。


[edit] パラメータ

  • cmtitle: エミュレートするカテゴリ
  • cmnamespace: これらの名前空間のページのみを一覧表示する
  • cmstart: このタイプスタンプで一覧表示を始める
  • cmend: このタイムスタンプで一覧表示を終わらせる
  • cmsort: ソートするプロパティ
    • sortkey: 記事のソートキー (デフォルト)
    • timestamp: 記事がカテゴリに追加された時間
  • cmdir: ソートするディレクション
    • asc: AからZへもしくは2002から2012へ。注: cmstartはcmendのでなければなりません
    • desc: ZからAへもしくは2012から2002へ注: cmstartはcmendよりもでなければなりません
  • cmlimit: 一覧表示するページの最大数(デフォルトで10)
  • cmprop: 取得するプロパティ
    • ids: ページのID (デフォルト)
    • title: ページのタイトル (デフォルト)
    • sortkey: ソートキー
    • timestamp: 記事がカテゴリに追加された時間と日付
  • cmcontinue: 以前のリクエストを持続するために使われる

[edit]

Category:Physicsに追加された最新の10の記事を取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <categorymembers cmcontinue="Magnetic levitation|" />
  </query-continue>
  <query>
    <categorymembers>
      <cm pageid="1653925" ns="100" title="Portal:Physics" />
      <cm pageid="22939" ns="0" title="Physics" />
      <cm pageid="3445246" ns="0" title="Glossary of classical physics" />
      <cm pageid="25856" ns="0" title="Radiation" />
      <cm pageid="16212316" ns="14" title="Category:Gravitation" />
      <cm pageid="24489" ns="0" title="List of basic physics topics" />
      <cm pageid="4412382" ns="0" title="Friability" />
      <cm pageid="1111581" ns="0" title="Reaction (physics)" />
      <cm pageid="16178400" ns="0" title="Normal (optics)" />
      <cm pageid="14476384" ns="0" title="Mass versus weight" />
    </categorymembers>
  </query>
</api>

[edit] 起こり得るエラー

  • code: cmnotitle
    • info: cmtitleパラメータが必要です
  • code: cminvalidcategory
    • info: 入力するカテゴリ名は有効ではありません
  • code: cmbadcontinue
    • info: 無効な持続パラメータ。以前のクエリで返されたオリジナルの値を渡すべきです

[edit] embeddedin / ei

MediaWiki version: 1.9

あるページをインクルードするページを一覧表示します。

[edit] パラメータ

  • eititle: このタイトルをインクルードするページを一覧表示します。タイトルは存在する必要はありません
  • einamespace: これらの名前空間のページのみを一覧表示します
  • eifilterredir: リダイレクトをフィルタする方法
    • all: リダイレクトフラグに関わらずすべてのページを一覧表示する (デフォルト)
    • redirects: リダイレクトのみを一覧表示する
    • nonredirects: リダイレクトを一覧表示する
  • eilimit: 一覧表示するページの最大数(デフォルトで10)
  • eicontinue: 以前のリクエストを持続するために使われる

[edit]

en:template:Stubを埋め込むすべてのページを見つける

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <embeddedin eicontinue="10|Stub|16324457" />
  </query-continue>
  <query>
    <embeddedin>
      <ei pageid="7997510" ns="0" title="Maike Evers" />
      <ei pageid="10357370" ns="0" title="ConnectU" />
      <ei pageid="11347592" ns="0" title="Oliver B. Greene" />
      <ei pageid="11886644" ns="0" title="Godfrey Burley Group" />
      <ei pageid="14882500" ns="0" title="Contra principia negantem disputari non potest" />
    </embeddedin>
  </query>
</api>

[edit] 起こり得るエラー

  • code: eibad_title_count
    • info: embeddedinクエリは始めるために1つのタイトルが必要です
      • eititle (この使い方は非推奨)の代わりにtitlesを使い複数のタイトルを指定するときに行われます
  • code: ei_badcontinue
    • info: 無効な持続パラメータ。以前のクエリによって返されたオリジナルの値を渡すべきです

[edit] exturlusage / eu

MediaWiki version: 1.11

Special:Linksearch形式、あるURLにリンクするページの一覧を取得する

[edit] パラメータ

  • euquery: プロトコル無しで、検索するURL。* はワイルドカードとして使うことができます
  • euprotocol: URLのプロトコル
    • このパラメータはwikiごとに変わります。デフォルトでは、オプションはhttp (デフォルト)httpsftpircgophertelnetnntpworldwindmailtonewsです
  • eunamespace: これらの名前空間のページからリンクのみを一覧表示します
  • eulimit: 一覧表示するページの最大数(デフォルトで10)
  • euprop: 取得するプロパティ
    • ids: リンクページのページID
    • title: リンクページのタイトル
    • url: リンクされているURL
  • euoffset: 以前のリクエストを持続させるために使われる

[edit]

slashdot.orgにリンクするページの一覧表示を取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <exturlusage euoffset="11" />
  </query-continue>
  <query>
    <exturlusage>
      <eu pageid="533948" ns="2" title="User:Peter Ellis" url="http://slashdot.org" />
      <eu pageid="3274" ns="2" title="User:Alexdb" url="http://slashdot.org/" />
      <eu pageid="36471" ns="2" title="User:Joao" url="http://slashdot.org/" />
      <eu pageid="246276" ns="2" title="User:Pablo Mayrgundter" url="http://slashdot.org/" />
      <eu pageid="352958" ns="2" title="User:Yckoh" url="http://slashdot.org" />
      <eu pageid="417592" ns="2" title="User:Geekboy" url="http://slashdot.org" />
      <eu pageid="439013" ns="4" title="Wikipedia:Village pump/January 2004 archive 5" url="http://slashdot.org" />
      <eu pageid="512464" ns="2" title="User:Vaceituno" url="http://slashdot.org" />
      <eu pageid="527793" ns="4" title="Wikipedia:New user log/archive1" url="http://slashdot.org" />
      <eu pageid="592017" ns="5" title="Wikipedia talk:Announcements/Archive 1" url="http://slashdot.org/" />
    </exturlusage>
  </query>
</api>

[edit] imageusage / iu

MediaWiki version: 1.11

任意の画像を含むページの一覧。ページのタイトル順。

[edit] パラメータ

  • iutitle:この画像を使うページを一覧表示する。画像が存在する必要はありません
  • iunamespace: これらの名前空間でページを一覧表示する
  • iufilterredir: リダイレクトをフィルタする方法
    • all: リダイレクトのフラグに関わらずすべてのページを一覧表示する (デフォルト)
    • redirects: リダイレクトのみを一覧表示する
    • nonredirects: リダイレクトを一覧表示しない
  • iulimit: 一覧表示するページの最大数(デフォルトで10)
  • iuredirect: 設定されると、リダイレクトを通してiutitleにリンクするページも一覧表示されます。詳細な情報に関してはlist=backlinksに関するドキュメントを参照
  • iucontinue: 以前のリクエストを持続するために使われる

[edit]

Image:Albert Einstein Head.jpgを使うすべてのページを見つける

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <imageusage iucontinue="6|Albert_Einstein_Head.jpg|45864" />
  </query-continue>
  <query>
    <imageusage>
      <iu pageid="736" ns="0" title="Albert Einstein" />
      <iu pageid="2201" ns="0" title="Aage Niels Bohr" />
      <iu pageid="12432" ns="0" title="Genius" />
      <iu pageid="14400" ns="0" title="History of science" />
      <iu pageid="34523" ns="0" title="Zhu Shijie" />
    </imageusage>
  </query>
</api>

[edit] 起こり得るエラー

  • code: iubad_title_count
    • info: imageusageクエリは始めるために1つのタイトルが必要です
      • titles instead of iutitle (この使い方は非推奨)の代わりにtitlesを使い複数のタイトルを指定するときに起きます。
  • code: iu_badcontinue
    • info: 無効な継続パラメータ。以前のクエリによって返されたオリジナルの値を渡すべきです
  • code: iubad_image_title
    • info: imageusageクエリのためのタイトルは画像でなければなりません

[edit] logevents / le

MediaWiki version: 1.11

Special:Log形式ですべてのログが記録されたイベントの一覧を表示する。このモジュールはジェネレータとして使うことはできません。

[edit] パラメータ

  • leprop: 取得するプロパティ
    • ids: questionとログID内のページのページID (デフォルト)
    • title: question内のページのタイトル (デフォルト)
    • type: ログエントリのタイプ (デフォルト)
    • user: ログエントリに関与するユーザ (デフォルト)
    • timestamp: ログが作成された時間と日付(デフォルト)
    • comment: ログのコメント (デフォルト)
    • details: 追加情報(すべてのログタイプに対して表示されない)(デフォルト)
  • letype: このタイプのログエントリのみを一覧表示する
    • block
    • protect
    • rights
    • delete
    • upload
    • move
    • import
    • patrol
    • merge
    • 拡張機能は別のログタイプを追加することがあります
  • leuser: このユーザによって作成されたログエントリのみを一覧表示する
  • letitle: このタイトルに関連するログエントリのみを一覧表示する
  • lestart: 一覧表示を始めるタイムスタンプ
  • leend: 一覧表示を終わらせるタイムスタンプ
  • ledir: 一覧表示するディレクション
    • older: 最新の最初のログエントリを一覧表示する(デフォルト)。注: lestartでなければなりません leend.
    • newer: 最も古いログエントリを最初から一覧表示する。注: lestartleendでなければなりません.
  • lelimit: 一覧表示するログエントリの最大数(デフォルトで10 )

[edit]

最新のページ移動を3件一覧表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <logevents lestart="2008-03-25T21:26:37Z" />
  </query-continue>
  <query>
    <logevents>
      <item
       logid="0"
       pageid="16577509"
       ns="1"
       title="Talk:Parisii (France)"
       type="move"
       action="move"
       user="QuartierLatin1968"
       timestamp="2008-03-25T21:31:39Z"
       comment="It is wrong to use such an anachronistic name.">
        <move new_ns="1" new_title="Talk:Parisii (Gaul)" />
      </item>
      <item
       logid="0"
       pageid="16577508"
       ns="0"
       title="Parisii (France)"
       type="move"
       action="move"
       user="QuartierLatin1968"
       timestamp="2008-03-25T21:31:38Z"
       comment="It is wrong to use such an anachronistic name.">
        <move new_ns="0" new_title="Parisii (Gaul)" />
      </item>
      <item
       logid="0"
       pageid="16577421"
       ns="10"
       title="Template:User Brunei work group"
       type="move"
       action="move"
       user="Black Falcon"
       timestamp="2008-03-25T21:28:02Z"
       comment="Has become a full WikiProject">
        <move new_ns="10" new_title="Template:User WikiProject Brunei" />
      </item>
    </logevents>
  </query>
</api>

[edit] 起こり得るエラー

  • code: leparam_user
    • info: ユーザ名usernameが見つかりません
  • code: leparam_title
    • info: Bad title value 'title'
      • letitleを無効なタイトルに設定したときに起こります

[edit] recentchanges / rc

MediaWiki version: 1.10

Special:Recentchanges形式でwikiの最近の変更のすべてを取得する。このモジュールはジェネレータとして使うことはできません。

[edit] パラメータ

  • rcstart: 一覧表示を始める時のタイムスタンプ
  • rcend: 一覧表示を終わらせる時のタイムスタンプ
  • rcdir: 一覧表示するディレクション
    • older: 最新の変更を最初から一覧表示する(デフォルト)。 注: rcstartrcendよりでなければなりません.
    • newer: 最も古い変更を最初から一覧表示する。注: rcstartrcendでなければなりません.
  • rclimit: 一覧表示する変更の最大件数 (デフォルトで10)
  • rcnamespace: これらの名前空間の変更のみを一覧表示する
  • rctitles: これらのタイトルへの変更のみを一覧表示する
  • rctype: あるタイプの変更のみを一覧表示する
    • edit: 通常のページ編集
    • new: ページ作成
    • log: ログエントリ
  • rcshow: これらの基準を満たす項目を一覧表示して下さい。(minor!minorといった)衝突するオプションを一緒に使うことはできません
    • minor: 細部の編集のみを一覧表示する
    • !minor: 細部の編集を一覧表示しない
    • bot: bot編集を一覧表示する
    • !bot: bot編集の一覧を表示しない
    • anon: 匿名ユーザによる編集のみを一覧表示する
    • !anon: 登録ユーザによる編集のみを一覧表示する
  • rcprop: 取得するプロパティ
    • user: 変更をしたユーザ
    • comment: 編集/ログのコメント
    • timestamp: 変更の時間と日時(デフォルト)
    • title:変更が行われたタイトル (デフォルト)
    • ids: ページID、リビジョンID、以前のリビジョンIDとRCID (パトロールのために使われる) (デフォルト)
    • sizes: 変更前後のページサイズ
    • patrolled: 変更がパトロールされるか。patrol権限を持つユーザのみが利用できます
    • flags:
      • new: 新しいページが作られた
      • minor: 変更は詳細な編集だった
      • bot: 変更はbotの編集だった

[edit]

サイズとフラグ付きの最新の変更を3件取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <recentchanges rcstart="2008-03-25T22:03:47Z" />
  </query-continue>
  <query>
    <recentchanges>
      <rc
        type="log"
        ns="-1"
        title="Special:Log/protect"
        rcid="205182563"
        pageid="0"
        revid="0"
        old_revid="0"
        user="Yamla"
        oldlen="0"
        newlen="0"
      />
      <rc
        type="new"
        ns="0"
        title="Clasico de Avellaneda"
        rcid="205182562"
        pageid="16578364"
        revid="200906507"
        old_revid="0"
        user="Eubot"
        bot=""
        new=""
        oldlen="0"
        newlen="66"
      />
      <rc
        type="edit"
        ns="3"
        title="User talk:Diligent Terrier"
        rcid="205182561"
        pageid="12353452"
        revid="200906506"
        old_revid="200863749"
        user="Basketball110"
        oldlen="202363"
        newlen="202761"
      />
    </recentchanges>
  </query>
</api>

[edit] 起こり得るエラー

  • code: rcshow
    • info: 無効なパラメータ -お互いに排他的な(両立しない)値は許可されません
  • code: rcpermissiondenied
    • info: パトロール済みのフラグをリクエストするpatrol権限が必要です

[edit] search / sr

MediaWiki version: 1.11

Special:Search形式ですべての記事の文字列に対して検索する

[edit] パラメータ

  • srsearch: 検索する文字列
  • srwhat: 検索する場所
    • title: ページのタイトルで検索する (デフォルト) (Wikimediaのwiki群では無効にされているので、代わりに srwhat=textを使って下さい)
    • text: ページテキストで検索する
  • srnamespace: これらの名前空間のみで検索する。デフォルトでは、mainの名前空間が検索されます
  • srredirects: リダイレクトの一覧表示もする
  • srlimit: 一覧表示するページの最大数(デフォルトで10)
  • sroffset: 以前のリクエストを持続するために使われる

[edit]

'wikipedia'という単語を含む10ページの一覧を表示する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <search sroffset="10" />
  </query-continue>
  <query>
    <search>
      <p ns="0" title="Wikipedia" />
      <p ns="0" title="French Wikipedia" />
      <p ns="0" title="German Wikipedia" />
      <p ns="0" title="Criticism of Wikipedia" />
      <p ns="0" title="2004" />
      <p ns="0" title="2005" />
      <p ns="0" title="Japanese Wikipedia" />
      <p ns="0" title="Spanish Wikipedia" />
      <p ns="0" title="History of Wikipedia" />
      <p ns="0" title="2007" />
    </search>
  </query>
</api>

[edit] 起こり得るエラー

  • code: srparam-search
    • info: 空の検索文字は許可されていません
  • code: srsearch-titles-disabled
    • info: タイトル検索が無効
  • code: srsearch-text-disabled
    • info: テキスト検索が無効

[edit] usercontribs / uc

MediaWiki version: 1.10

修正時間順で任意のユーザによって、行われた投稿の一覧を取得する。このモジュールはジェネレータとして使うことはできません。

[edit] パラメータ

  • ucuser: 投稿を取得するユーザ
  • ucuserprefix: この文字列で始まる名前を持つすべてのユーザの投稿を一覧表示する。ucuserをオーバーライドします
    • これはIPの範囲の投稿を取得するために便利です。
    • このオプションを使うとき、投稿のソートは最初、ユーザ、次にタイムスタンプで行われることに留意して下さい。
  • ucstart: 一覧表示を始めるときのタイプスタンプ
  • ucend: 一覧表示を終わらせるときのタイムスタンプ
  • ucdir: 一覧表示するディレクション
    • older: 最新の投稿を最初から一覧表示する(デフォルト)。 注: ucstartucendでなければなりません
      • ucuserprefixを使う場合、ユーザは降順(ZからA)で一覧表示されます
    • newer: 最も古い投稿を最初から一覧表示する。注: ucstartucendでなければなりません
      • ucuserprefixを使う場合、ユーザは昇順(AからZ)で一覧表示されます
  • uclimit: 一覧表示する投稿の最大件数(デフォルトで10)
  • ucnamespace: これらの名前空間の投稿のみを一覧表示する
  • ucshow: これらの基準を満たす投稿のみを一覧表示する。矛盾するオプション(minor!minorなど)は一緒に使うことはできません
    • minor: 細部の編集のみを一覧表示する
    • !minor: 細部の編集を一覧表示しない
  • ucprop: 取得するプロパティ
    • ids: ページIDとリビジョンID
    • title: 変更されたページのタイトル
    • timestamp: 投稿の時間と日付
    • comment: 編集/ログのコミット
    • flags:
      • new: 新しいページが作成された
      • minor: 変更が細部の編集だった
      • bot: 変更がbotの編集だった

[edit]

en:User:Catropeによる投稿を3件取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <usercontribs ucstart="2007-06-11T09:23:57Z" />
  </query-continue>
  <query>
    <usercontribs>
      <item
        user="Catrope" pageid="11650099" revid="136629050"
        ns="3" title="User talk:Catrope" timestamp="2007-06-07T16:45:30Z"
        minor="" comment="Creation; directing to BW"
      />
      <item
        user="Catrope" pageid="11650100" revid="136629120"
        ns="2" title="User:Catrope" timestamp="2007-06-07T16:45:49Z"
        new="" minor="" comment="Creation; directing to BW"
      />
      <item
        user="Catrope" pageid="3383874" revid="136629407"
        ns="3" title="User talk:Ruud Koot" timestamp="2007-06-07T16:47:09Z"
        comment="Nested collapsible tables fix"
      />
    </usercontribs>
  </query>
</api>

[edit] 起こり得るエラー

  • code: ucparam_user
    • info: ユーザ名usernameが無効
  • code: ucparam_user
    • info: ユーザパラメータは空が許可されない
  • code: ucshow
    • info: 不正なパラメータ - お互いに排他的な値の供与は許可されない

[edit] watchlist / wl

MediaWiki version: 1.10

任意の時間の期間内に変更された現在のユーザのウォッチリスト上のページの一覧を取得する。ウォッチされているページの最終変更の時間で並べられている。

[edit] パラメータ

  • wlstart: 一覧表示を開始するときのタイムスタンプ
  • wlend: 一覧表示を終了するときのタイムスタンプ
  • wldir: 一覧表示するディレクション
    • older: 最新の変更ページを最初から一覧表示する(デフォルト). 注: wlstartwlendよりでなければなりません
    • newer: 一番更新歴が古いページを最初から一覧表示する。 注: wlstartwlendよりでなければなりません.
  • wllimit: 一覧表示するページの最大数(デフォルトで10)
  • wlnamespace: これらの名前空間のページのみを一覧表示する
  • wlallrev: 複数のリビジョンを同じページに含める。このパラメータをジェネレータモードで使うことはできません。
  • wlshow: これらの基準を満たすリビジョンのみを一覧表示する。矛盾するオプション(minor!minorなど)を一緒に使うことはできません
    • minor: 細部の編集のみを一覧表示する
    • !minor: 細部の編集を一覧表示しない
    • bot: botの編集のみを一覧表示する
    • !bot: botの編集を一覧表示しない
    • anon: 匿名ユーザによる編集のみを一覧表示する
    • !anon: 登録ユーザによる編集のみを一覧表示する
  • wlprop: 取得するプロパティ
    • user: 変更を行ったユーザ
    • comment: 編集/ログのコメント
    • timestamp: 変更の時間と日付
    • title: 変更がなされたタイトル(デフォルト)
    • ids: ページID、リビジョンID、以前のリビジョンIDとRCID (パトロールのために使われる) (デフォルト)
    • sizes: 変更の前後のページサイズ
    • patrol: 変更がパトロールされているかどうか。patrolの権限を持つユーザのみが利用可能
    • flags: (デフォルト)
      • new: 新しいページが作られた
      • minor: 変更が細部の編集だった
      • bot: 変更がbotの編集だった

[edit]

現在のユーザのウォッチリストを取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <watchlist wlstart="2008-03-04T16:01:48Z" />
  </query-continue>
  <query>
    <watchlist>
      <item pageid="16396" revid="176417" ns="0" title="API:Query - Lists" />
      <item pageid="25300" revid="176413" ns="1" title="Talk:Summer of Code 2008" />
      <item pageid="24947" revid="176089" ns="0" title="Summer of Code 2008" />
      <item pageid="16377" revid="174495" ns="0" title="API:Query" />
      <item pageid="16393" revid="174239" ns="0" title="API:Query - Meta" minor="" />
      <item pageid="16375" revid="174222" ns="0" title="API:Login" />
      <item pageid="16391" revid="174216" ns="0" title="API:Data formats" minor="" />
      <item pageid="14588" revid="174214" ns="0" title="API" />
      <item pageid="18710" revid="173571" ns="1" title="Talk:API:Edit - Create&amp;Edit pages" />
      <item pageid="20025" revid="173412" ns="1" title="Talk:API:Query" />
    </watchlist>
  </query>
</api>

[edit] 起こり得るエラー

  • code: wlnotloggedin
    • info: ウォッチリストを得るためにログインしなければならない
  • code: wlpatrol
    • info: patrolプロパティが利用可能ではない
  • code: wlshow
    • info: 無効なパラメータ - お互いに排他的な値の供与は許可されない

[edit] deletedrevs / dr

MediaWiki version: 1.12

削除されたリビジョンを一覧表示します。このモジュールを使うために deletedhistoryの権限が必要です。このモジュールをジェネレータとして使うことはできません。

[edit] パラメータ

  • drstart: 一覧表示を始めるときのタイムスタンプ
  • drend: 一覧表示を終わらせるときのタイムスタンプ(オプション)。指定されない場合、drstartより後のすべてのすべてのリビジョンが一覧表示される。
  • drdir: 一覧表示するディレクション。
    • older: 最新のリビジョンを最初から一覧表示する(デフォルト)。注: drstartはdrendよりでなければなりません.
    • newer: 最も古いリビジョンを最初から一覧表示する。注: drstartはdrendよりでなければなりません
  • drlimit: 一覧表示するリビジョンの最大件数(デフォルトは10 )
  • drprop: 取得するプロパティ
    • revid: リビジョンID
    • user: 編集を行ったユーザ(デフォルト)
    • comment: 編集のコメント (デフォルト)
    • minor: 細部の編集であるかどうか
    • len: リビジョンのサイズ
    • content: リビジョンの内容。このオプションを使うためにundeleteの権限が必要
    • token: トークンを復元する

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

September 4, 2007の日付を持つ最新の削除されたリビジョンを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] 起こり得るエラー

  • code: drpermissiondenied
    • info: 削除されたリビジョンの情報を閲覧するパーミッションがありません*** 大抵のwiki上では、削除されたリビジョンの閲覧はsysopに制限されますが、wikiの中にはさらに厳しいルールを課しているものもあります。
  • code: drpermissiondenied
    • info: 削除されたリビジョンの内容を閲覧するパーミッションを持ちません

[edit] users / us

MediaWiki version: 1.12

ユーザの一覧に関する情報を取得します。このモジュールをジェネレータとして使うことはできません。

[edit] パラメータ

  • ususers: 情報を取得するユーザ名の一覧
  • usprop: どのプロパティを取得するか
    • blockinfo: ユーザが誰によってなぜブロックされているのかどうか
    • groups: ユーザが所属しているすべてのグループ
    • editcount: ユーザが行った編集回数

[edit]

ユーザの一覧に関する情報を取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <users>
      <user name="1.2.3.4" invalid="" />
      <user name="Catrope" editcount="203">
        <groups>
          <g>bot</g>
          <g>bureaucrat</g>
          <g>steward</g>
          <g>sysop</g>
          <g>trusted</g>
        </groups>
      </user>
      <user name="Vandal01" editcount="1" blockedby="Catrope" blockreason="Intimidating behaviour/harassment" />
      <user name="Bob" missing="" />
    </users>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] random / rn

MediaWiki version: 1.12

ランダムページの一覧を取得する。

ページは修正された順番で一覧表示され、起点のみがランダムです。これは、例えば、一覧表で"Main Page"が最初のランダムページの場合、"List of fictional monkeys"は常に2番目、"List of people on stamps of Vanuatu"は3番目、などであることを意味します。

[edit] パラメータ

  • rnlimit: 返すページの最大数(デフォルトで1)
    • 名前空間のページ数がrnlimitより小さい場合、もっと少ないページを得ることになります。同じページを2回取得することにはなりません。
  • rnnamespace: これらの名前空間のページのみを一覧表示する

[edit]

5のランダムページを取得する

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <random>
      <page title="History of Indian Institutes of Technology" ns="0" id="4939430" />
      <page title="Talk:International Karate +" ns="1" id="1904217" />
      <page title="Selion" ns="0" id="758503" />
      <page title="User talk:Yenandzen" ns="3" id="12454962" />
      <page title="User talk:66.138.5.211" ns="3" id="9965621" />
    </random>
  </query>
</api>

[edit] 起こり得るエラー

無し

Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox