価格コム　WEBサービス　API マニュアル

バージョン：1.0
1.旅行写真検索ＡＰＩ
a.リクエストURL
http://api.4travel.jp/Ver1/SearchPicture.php?パラメータ名=パラメータ値・・・
b.リクエストパラメータ
パラメータ名 説明
model カメラのモデル名を指定（マスタ参照）
※必須
format 出力フォーマットを指定
・xml（xmlフォーマットで出力）
・php（シリアライズして出力）
・json（jsonフォーマットで出力）
・jsonp（jsonpフォーマットで出力）
※指定のない場合xmlを適用
outputcharset
エイリアス: oc 		出力する文字コードを選択
・sjis
・euc
・utf8
※指定のない場合はUTF-8を適用
max 最大取得件数を指定
※指定のない場合、10を適用
※最大50件まで表示
callback
format=jsonp時のみ		 コールバック関数名を指定
※指定のない場合callbackを適用
c.リターンパラメータ
パラメータ名 説明 データ型
numofresult リターンする旅行記の数
0件の場合は”0”を返す。 		Integer
picturl 写真のURL String
comment 写真のコメント String
pictlink 写真のある旅行記ページのURL
※大きいサイズのイメージを見ることができます。		 String
※結果の並び順はランダムです。
d.サンプル
リクエスト(format：xmlの場合)
http://api.4travel.jp/Ver1/SearchPicture.php?model=cybershot&max=3
結果
結果（ヒットした旅行記がなかった場合）
リクエスト(format：phpの場合)
http://api.4travel.jp/Ver1/SearchPicture.php?model=cybershot&max=3&format=php
結果
リクエスト(format：jsonの場合)
http://api.4travel.jp/Ver1/SearchPicture.php?model=cybershot&max=3&format=json
結果
リクエスト(format：jsonpの場合)
http://api.4travel.jp/Ver1/SearchPicture.php?model=cybershot&max=3&format=jsonp
※keywordに指定した文字列は、文字コードEUC-JPの「リゾート」をURLエンコードしたものです。
結果
e.エラー
エラーコード 内容
invalid_format 出力フォーマットの値が不正です。
invalid_outputcharset 出力文字コードの値が不正です。
invalid_max 最大取得件数の値が不正です。
出力フォーマットがPHPの場合、アンシリアライズすると上記メッセージになります。 XML、JSON、JSONPの場合のエラー判定は以下を参照してください。
invalid_formatの場合

<?xml version="1.0" encoding="UTF-8" ?>
<results>
<title>旅行写真</title>
<error>
<message>invalid_format</message>
</error>
</results>


invalid_outputcharsetの場合

XML

<?xml version="1.0" encoding="UTF-8" ?>
<results>
<title>旅行写真</title>
<error>
<message>invalid_outputcharset</message>
</error>
</results>


JSON

{"item":{"error":"invalid_outputcharset"}}


JSONP

callback({"error":"invalid_outputcharset"})

invalid_maxの場合

XML

<?xml version="1.0" encoding="UTF-8" ?>
<results>
<title>旅行記</title>
<error>
<message>invalid_max</message>
</error>
</results>


JSON

{"item":{"error":"invalid_max"}}


JSONP

callback({"error":"invalid_max"})