with.I event finder API とは
概要
with.I event finder API とは、with.I event finderのコンテンツを任意のアプリケーションから利用するためのAPIです。with.Iの所有する全イベントデータの検索及び詳細データ取得をサポートしています。
インタフェースは HTTP GET に対して XML で処理結果を返す、REST API です。
with.I event finder API についてのお問い合わせはこちらから
データ取得方法
with.I event finder 内のデータを任意キーワードで全文検索が可能です。ゆらぎ検索（オタクシソーラス検索）にも対応しています。検索結果はXMLによって取得できます。たとえば、「銀魂」の情報を取得する場合は以下のURLになります。
keyword
URLエンコードしたキーワード名
page
取得する検索結果ページ
past
今日以降のデータを取得する場合は「2」、過去のデータも取得する場合は「1」を指定
なお、検索結果はイベント開催日順にソートされます。
文字エンコード
文字コードはUTF-8を推奨します。サーバ内でも文字コードの判別を行っていますが、UTF-8にしていただけると安全です。
レスポンス
検索結果はUTF-8のXMLで返ってきます。
<DetailPageURL>
http://finder.with-i.jp/event_detail.php?event_id=xxx
</DetailPageURL>
<EvnetTitle>
<Name>with.I</Name>
<Yomi>うぃずあい</Yomi>
</EvnetTitle>
<Date>20000101</Date>
<LimitDate>20000101</LimitDate>
<Genre>
<Main>攻殻機動隊</Main>
<Detail>トグサオンリー</Detail>
</Genre>
<Place>
<Prefecture>東京都</Prefecture>
<Hall>東京ビックサイト</Hall>
</Place>
<Time>
<Start>0000</Start>
<End>0000</End>
</Time>
<Costume>コスプレ可</Costume>
<CostumePrice>300</CostumePrice>
<Photographing>写真撮影可</Photographing>
<PhotographingPrice>500</PhotographingPrice>
<CircleAttributes>
<Scale>40</Scale>
<SpPrice>3000</SpPrice>
<ConsignScale>30</ConsignScale>
<ConsignSpPrice>1500</ConsignSpPrice>
<JoinType>イベントで申込書入手</JoinType>
<JoinType>申込書の郵送を希望</JoinType>
<JoinType>PDFのダウンロード</JoinType>
</CircleAttributes>
<Pamphlet>パンフレット有</Pamphlet>
<Organizer>with.I</Organizer>
<EventURI>http://finder.with-i.jp/</EventURI>
<BannerAddress>http://finder.with-i.jp/img/banner.gif</BannerAddress>
<Etc>おやつは500円まで</Etc>
ID
イベントのID
DetailPageURL
イベント情報の詳細ページURL
EventTitle Name
イベント名
EventTitle Yomi
イベント名のひらがな読み
Date
イベント開催日
LimitDate
サークル参加締め切り日
Genre Main
メインジャンル
Genre Detail
ジャンル詳細（○○受け、○○オンリー等）
Place Prefecture
開催場所の都道府県
Place Hall
開催場所
Time Start
イベントが始まる時間
Time End
イベントが終わる時間
Costume
コスプレが可能か否か
CostumePrice
コスプレ料
Photographing
写真撮影が可能か否か
PhotographingPrice
写真撮影料
CircleAttributes Scale
直接参加サークルのスペース数
CircleAttributes SpPrice
直接参加1sp値段
CircleAttributes ConsignScale
委託参加サークルのスペース数
CircleAttributes ConsignSpPrice
委託参加1sp値段
CircleAttributes JoinType
イベントの申し込み形式
Pamphlet
パンフレットの有無
Organizer
主催者名
EventURI
イベント告知サイトURL
BannerAddress
直リンク用バナーアドレス
Etc
その他特記事項
エラーメッセージ
リクエストが失敗した場合エラーメッセージを返します。これはAPIを使うプログラムから使用されることを意図しています。
<Error>
<Code>エラーコード</Code>
<Message>エラーメッセージ</Message>
</Error>
</Errors>
エラーメッセージは以下の通りです。
NoRequest
必ずキーワードを指定してください。
NoMatches
該当するイベント情報がありません。
注意事項
このデータベース情報はwith.I内の情報です。
正確を期すためにご利用の前に必ず一次情報(イベントサイト等)ご確認いただけるよう、お願いいたします。