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

