1.023world API

ショップ新着案内API では、掲載に関して承諾が得られたショップについて、各サイトから取得した新着案内情報を提供します。 レスポンスには、ショップ名、ショップサイトURL、更新日時、新着案内テキスト（抜粋）が含まれます。

ショップ新着案内API は、REST（Representational State Transfer）形式で提供されます。 API へのリクエストにはGETを用いてクエリーを渡してください。レスポンスはXMLで返されます。

主にCGI/PHP等を用いてAPIからXMLを取得できますが、JavaScriptからの取得についてもこれらのアシストが必要になります。 詳しくはクロスドメインPHPのページも参考にしてください。

なお、API 側には crossdomain.xml も設置されていますので、FLASHによる取得も可能です。

リクエストURL

http://api.shop.1023world.net/

リクエストパラメータ

パラメータ	値	説明
---	---	リクエストURL にパラメータを一切与えない場合、自動的に各パラメータにデフォルト値が割り当てられ、リストデータを返します。
list	integer (1-20)	取得するリスト数を与えます。デフォルト値は5です。
limit	integer (1-365)	より最新の新着データを絞り込むための日数を与えます。デフォルト値は365（1年）です。 なお、この値に関係なく、返されるリストは更新日時で降順ソートされています。
length	integer (10-60)	新着案内テキストの抜粋文字数（半角換算値）を与えます。区切り点に2バイト文字（全角文字）を含む場合は1バイト繰り上げられます。デフォルト値は60です。

各パラメータは、省略するとデフォルト値が割り当てられます。

レスポンスフィールド

フィールド	説明
result	レスポンス全体を内包するトップレベル要素です。result には以下の属性が与えられています。 type="ShopInformation-API" list="リスト件数" limit="最新日数" length="抜粋文字数"
shop	ショップデータを内包する要素です。複数出現します。 result>shop
name	ショップ名を内包する要素です。 result>shop>name
link	ショップサイトURLを内包する要素です。 result>shop>link
info	新着案内テキスト（抜粋）を内包する要素です。 result>shop>info
date	更新日時を内包する要素です。YYYY/MM/DD 00:00形式です。 result>shop>date

レスポンスサンプル

実際に取得したXMLをパースするには、以下の例を参照して、ウェブアプリケーション開発にお役立てください。 （スキーマの記述は省略しています）

パラメータ指定例 ： http://api.shop.1023world.net/?list=5&limit=30&length=30

<?xml version="1.0" encoding="utf-8"?> <result type="ShopInformation-API" list="5" limit="30" length="30"> <shop> <name>Kaiba-World</name> <link>http://www.kaiba-world.com/</link> <info> 7/29 TATU-SHOP KAIBA-WORLD 入...</info> <date>2008/07/30 10:00</date> </shop> <shop> <name>マリンメイト</name> <link>http://www.ne.jp/asahi/marine-mate/hp/</link> <info>2008.7.27入荷 ミドリイシ，コモ...</info> <date>2008/07/29 02:09</date> </shop> <shop> <name>やどかり屋</name> <link>http://yadokariya.jp/</link> <info>オカヤドカリSサイズ入荷！ オカ...</info> <date>2008/07/26 17:26</date> </shop> <shop> <name>オープンウォーター</name> <link>http://www16.ocn.ne.jp/~openw/</link> <info>2008年7月26日 クィーンエンゼル...</info> <date>2008/07/26 01:45</date> </shop> <shop> <name>マンゴインターナショナル</name> <link>http://www.mangointernational.com/</link> <info>2008/07/25 『サンゴ砂 No.0（パ...</info> <date>2008/07/25 04:12</date> </shop> </result> <!-- api.shop.1023world.net 0.01sec -->

利用制限

ショップ新着案内API は、24時間以内で1ホスト（IP）あたり5000件のリクエストが上限となります。

クレジット表示

ショップ新着案内API をご利用になる場合、公開するウェブアプリケーションの下（なるべく近い位置）に以下のようなクレジット表示が必要です。 以下のリンクタグをこのままコピーして貼付してください。改変は一切禁止です。
<a href="http://www.1023world.net/api" target="_blank">ウェブサービス by 1.023world</a>