ホームページ -> 声優さん出演リスト -> Web-APIのご案内
 −Web-API のご案内− 
以前、一度着手しかけてそのまま頓挫していたAPI公開計画です
俺の知識が増えたわけでもなく相変わらずAPIはよくわかりませんが、とりあえず出来た所までを一度公開してみようと思います


 APIって何じゃい?何が出来るんじゃい? 
説明しようにも、俺自身がよくわかっていないので説明出来ん。。と言う事で、APIの意味に付いてはネット等でお調べくださいw
具体的に何が出来るのかって事ですが、これは実際に見て頂いた方が早いと思いますので、まずは下記リンクのサンプルをご覧ください

APIのサンプル

検索ワードに適当な声優名を入力して実行すると、その声優の登録情報が表示されると思います
この結果だけ見ると「声優DBの検索と何が違うの?結果表示を簡素化してるだけじゃね?」って感じかもしれませんが、ポイントは

この「検索〜結果の受取り」を外部のプログラムから実行出来る

という点です。ご自分のHPに検索フォームを設置すれば、そこからDB内のデータを引っ張れます。もう一つのポイントは

抽出結果を自分の好きなように表示(利用)出来る

という点です。サンプルの通り、データは「<>」で区切られた一行一件の形で返ります。受信データを配列に格納し「<>」で分割すれば データ中の必要な部分だけを表示させたりと自由自在に加工する事が可能です。更に言えば、表示に用いるだけではなく他プログラムの 何かしらの内部データとして値を利用するなんて事も可能です。声優DBでの検索との一番の相違は、この「受け取ったデータを自前のプログラムで 自由に扱える」という点になります。


 APIの仕様と必要環境 
SOAP-Liteを用いています。利用するにはお使いのサーバーにSOAP-Liteモジュール(SOAP-Lite-0.60aにて動作確認)がインストールされている必要があります。 ご自分のサーバーが対応しているかどうかは、お使いのプロバイダー等にお尋ねください(対応してる所は多分そんなに多くないだろうな〜…)

確認用のスクリプトを置いておきますので、アップロードして実行してみてください。「ok」と返ってくればSOAP-Liteが使えます。ちなみに、モジュールが 入っていない場合どういうエラーを返すのかわかりませんw

確認用スクリプト
*右クリック→名前を付けて保存→拡張子を「cgi」に変更→サーバーへアップロード→パーミッション設定→アクセス の手順で

※言い忘れましたが、SOAP-Liteモジュール以前の問題として、まずCGIが使える事が大前提ですw

■メソッド及び返送データの仕様
Searchメソッド
目的声優情報の検索
引数 検索対象今の所、検索対象は「声優名」のみです
検索ワード声優名(の一部)を入力。スペース区切りで複数可
検索タイプ1「or」「and」のいずれかを指定。検索ワードに複数キーワードを入力した際に「かつ」「または」のどちらで絞込みを行うかを指定
検索タイプ2「all」「limiti」のいずれかを指定。「all」にすると、検索に合致した声優に含まれるキャラ情報も一緒に引っ張る。「limit」だと声優情報のみを引っ張る。

Queryメソッド
目的指定した声優の登録情報を抽出(検索に対し、こちらは目的の声優さんを直接指定します)
引数 声優コード半角数字五桁。目的の声優の登録コードを入力
オプション指定「on」「off」のいずれかを指定。返り値に、声優情報を含めるかどうか。onで含む(一行目に返す) offだとキャラ情報のみを返す
補足*声優コードの調べ方…声優さん出演リストのトップページで、目的の声優さんをクリックし個別情報を表示してください。その際、ブラウザのアドレス欄に表示されるアドレスで調べる事が出来ます。
例:■佐藤美佳子(Mikako Satoh)=神村ひな=MIKAKOの場合
http://gph.sakura.ne.jp/va_memo/system/vadb.cgi?action=view_ind&value=00042&namecode=2
赤字の部分(00042)が声優コードとなります。

返送データ(共通)
マッチするデータが存在しない場合は「no match」と返ります
一致するデータが存在した場合、各項目を「<>」で区切った一行一件(\nで区切り)形式で返ります

[項目詳細]
M<>00042<>40<>佐藤美佳子<>Mikako Satoh<>神村ひな=MIKAKO<>http://www.geocities.co.jp/HeartLand- Himawari/4139/<>21<>06/07/09 05:23<>1152390186<>
種別(声優名情報は「M」、キャラ情報は「S」)<>声優コード<>登録件数<>名前1<>名前1のローマ字表記<>名前2(別名)<>ホームページ(存在する場合)<>頭文字コード<>最終更新時間(date)<>最終更新時間(time関数)<>

S<>00042<>1126022991<>吉祥すずな<>着せかえフェティッシュ!< >戯画<>2005年09月09日<>貧乳ナースな先輩さん♪<>PC(18禁)<>
種別(声優名情報は「M」、キャラ情報は「S」)<>声優コード<>最終更新時間(time)<>キャラ名<>タイトル<>メーカー名<>発売日<>コメント<>種別<>



 ご利用の方法と約束事 
まずご利用方法なんですが、とりあえず事前にご連絡頂く形にさせてもらおうかなと思います。何せサーバーがあんまり強く無いもんで、、
現状でさえ503エラー吐いちゃってるんで、このAPIによって負荷がどの程度増す物なのか、それがある程度読めるまではオープンにし辛くて…

次に利用に際してのお約束ですが、これがちょっと面倒で申し訳

1.基本的にサポートは行いません
出来るだけ質問には答えようと思っていますが細かいサポートは出来ませんので、perlなりjavaなり、お使いになるプラットフォームの 知識がある程度必要かと思われます(Perlに関しては特に難しい事は無いです。配列に引っ張ってくる所までは定型の書式がありますので、配布されてる スクリプト等に自分でちょっとした改造を加える事が出来るくらいの知識があればいけるかと。javaに関しては俺自身が全くわかりませんので、質問されても一切答えられませんw)

2.当HPへのリンク
用途に制限は無くどのような形でご利用頂いても構いませんが、それを公開する場合は必ず分かり易い場所に当HP(声優DB)へのリンクを 張っつけて下さい(↓バナーでっかいのとちっこいの作ってみました)
 

3.仕様の変更及びサービスの停止
状況によりAPIの仕様を変更したりサービス自体を停止(一定期間あるいは無期限)したりする可能性があります。 いずれの場合も数日前に告知を行いますが、緊急を要する事態においてはその限りではありません。

以上の条件でもいいよ〜って方はまでご連絡下さい
(後、掲示板(API専用スレ作っておきますので)にも「メール送ったよー」とか一筆頂けると有難いかもかも)
折り返し、APIにアクセスするためのIDとサンプルソースをお送りします

その他、何か不明な点やご要望等ありましたら掲示板にてお願いします〜ノシ

VaDb Rev3-Ver6.00 presented by GamePlaza-HARUKA- Script Written by Toshi