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

バージョン:1.0
4.掲示板情報取得API
a.リクエストURL
http://api.kakaku.com/WebAPI/BBSInfo/Ver1.0/BBSInfo.asp?パラメータ名=パラメータ値・・・
b.リクエストパラメータ
*ApiKey、ProductIDの指定が必須となります。
パラメータ名 説明
ApiKey アクセスキー(1日の利用制限は5000回です)
ProductID 検索したいアイテムのプロダクトIDを指定します。
SortOrder 検索結果を表示する順番を指定します。
DateTime :最新書込み順
Code :書込み番号順
指定しない場合は、Code順となります。

並び順の複数指定は、できません。
Filter 検索対象の書込み分類を指定します。

分類名パラメータ値
質問1
レポート良い2
レポート悪い3
指定しない場合は、全ての書込み分類が対象となります。
c.リターンパラメータ
ヒットした掲示板情報をXML形式で、最大5つまでのスレッドの情報を返します。(文字コードはUTF-8)
パラメータ名 説明 データ型
NumOfResult 該当親スレッド数
0件の場合はエラーコード”NoEntry”を返します。
Integer
ThreadTitle 親スレッドのタイトル(全角で頭から30文字) String
ThreadId ユニークなスレッドID Integer
ThreadClass スレッドの種類(1:質問、2:レポート良い、3:レポート悪い、0:その他) Integer
ThreadUrl スレッドURL String
ThreadSummary 親スレッドクチコミ内容(全角で頭から100文字) String
NickName 親スレッドクチコミの書込み者のニックネーム String
NumOfResponse 返信数 Integer
WrittenDate 投稿日 String
d.サンプル
リクエスト
http://api.kakaku.com/WebAPI/BBSInfo/Ver1.0/BBSInfo.asp?ProductID=20274010022& SortOrder=DateTime&Filter=1&ApiKey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
の場合。
結果
e.エラー
エラーコード 内容
NoEntry 該当する書込みが1件もありませんでした。
InvalidParameterValue パラメータの値が入っていないか、不正です。
No registration 登録されていないアクセスキーです。
Exceeded daily maximum 1日のアクセス制限を超えました。
Too many accesses 制限を超えたアクセスがありました。
Blocked IP address 禁止されているIPからのアクセスです。
InternalServerError サーバは、処理を完了できませんでした。
NoEntryの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>NoEntry</Message>
</Error>

InvalidParameterValueの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>InvalidParameterValue</Message>
</Error>

No registrationの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>No registration</Message>
</Error>

Exceeded daily maximumの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>Exceeded daily maximum</Message>
</Error>

Too many accessesの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>Too many accesses</Message>
</Error>

Blocked IP addressの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>Blocked IP address</Message>
</Error>

InternalServerErrorの場合

<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>InternalServerError</Message>
</Error>