GyaASE API (Beta)

GyaASE API とは?

GyaASE API とは、GyaASE の内部で使っているサーバ検索バックエンドを Web API として呼びだせるようにしたものです。この GyaASE API を使うと、自分の Web ページや Blog にサーバの一覧を表示させたり、オリジナルのサーバブラウザを作ることができます。

1. お気に入りサーバ表示 API (IP アドレス指定)

下のコード例のような JavaScript を Web ページ中に書くと、お気に入りサーバ一覧を埋めこむことができます。hosts の部分に以下のフォーマットでお気に入りのサーバの情報に書いてください。複数のサーバを書く場合はカンマ(,)で区切ってください。

var hosts = 'ゲーム://IPアドレス:ポート,ゲーム://IPアドレス:ポート,...';
ゲームは、warsow, q3, q3116, q4, et, nexuiz, cs, cscz, css, hl2mp, dods, tfc, ship, ut2004, bf1942, bf2, bf2d, bf2142, bf2142d, pk, aao, fear, cod, coduo, cod2, roo, mohaa, mohaas, mohaab, savage のどれかを指定してください。

実行例

コード例

以下をコピーして hosts の部分を変更してから Web ページや Blog に貼りつけてください。

2. サーバ一覧表示 API (ゲーム・国指定)

上の例と同様に、サーバ一覧をゲームと国を指定して埋めこむこともできます。game と country_code の部分に表示したいゲームと国を指定してください。こちらの方法は IP 指定の方法に比べるとだいぶ重いので、上の IP 指定のほうを利用することをお勧めします。

実行例

コード例

以下をコピーして game と country_code の部分を変更してから Web ページや Blog に貼りつけてください。

3. ゲーム起動 API

ゲームを起動してサーバに接続するためのリンクを Web に書くことができます。以下のような URL で、ゲーム、IPアドレス、ポートを指定します。

http://d3.jpn.org/gyaase/launch.php/ゲーム://IPアドレス:ポート.bat

実行例

guwashi.ddo.jp サーバに接続します

コード例

4. サーバリスト取得 API (XML, RSS, HTML, テキスト) [開発者向け]

以下の URL からサーバリストを各種フォーマットで取得することができます。このサーバリストを加工することによってオリジナルのサーバブラウザを作成することが可能です(実際 GyaASE はこのサーバリストを XML 形式で取得して、JavaScript で加工して表示しています)。サーバリストを取得する URL は以下の通りです。

http://d3.jpn.org/gyaase/gyastat.php?format=フォーマット&max=最大件数&start=開始件数&game=ゲーム&country_code=
フォーマットは xml, rss1.0, html, js, text のどれかを指定してください。

この API を使って何か新しいものを作ってみたいという方は是非 Guwashi までご一報ください :D

実行例

XML フォーマット (format=xml)
RSS フォーマット (format=rss1.0)
HTML フォーマット (format=html)
JavaScript フォーマット (format=js)
テキストフォーマット (format=text)

コード例

http://d3.jpn.org/gyaase/gyastat.php?format=xml&max=20&start=1&game=warsow&country_code=JP
http://d3.jpn.org/gyaase/gyastat.php?format=rss1.0&max=20&start=1&game=warsow&country_code=JP
http://d3.jpn.org/gyaase/gyastat.php?format=html&max=20&start=1&game=warsow&country_code=JP
http://d3.jpn.org/gyaase/gyastat.php?format=js&max=20&start=1&game=warsow&country_code=JP
http://d3.jpn.org/gyaase/gyastat.php?format=text&max=20&start=1&game=warsow&country_code=JP

コメント・要望・感想

コメント・要望・感想等ありましたら以下の方法で Guwashi まで教えてください。


Guwashi / guwashi999 at gmail dot com