ホットペッパー Webサービス／ガイドライン

■2007.11.19 ホットペッパーWebサービスはリクルートWebサービスに統合されました。
ホットペッパーWebサービスはリクルートWebサービスに統合されました。そのためリクルートWebサービスの利用規約が適用されますので、こちらをご覧ください。
現在公開中の「ホットペッパーWebサービス(http://api.hotpepper.jp)」に関しましては、リクルートWebサービスへの統合後も当面の間稼動いたしますが、今後はサービスレベルの向上や機能追加等を行わない計画ですので、新しく開発をされる方は、 http://webservice.recruit.co.jp/hotpepper/で提供されるリクルートWebサービス版をお使いください。

クレジット表示について

※ホットペッパーWEBサービスはリクルートWEBサービスに統合されました。新規開発される場合のクレジット表示に関しては、リクルートWEBサービス＞ホットペッパー FooMoo＞ご利用案内をご覧ください。
既存のホットペッパーWEBサービス利用アプリケーションに関しては当面の間、引き続き以下のクレジット表示をお使いいただけます。

■表示義務について

ホットペッパー Webサービスの提供するAPIを利用するすべてのサイトやアプリケーションには、以下のクレジットを表示してください。

1.クレジットの選択

掲載するクレジットを以下より選択してください。

	表示形式	クレジット
a	画像形式小　155px × 20px
b	画像形式中　100px × 35px
c	画像形式大　150px × 50px
d	テキスト形式	Powered by ホットペッパー FooMoo

2.クレジットのHTMLソース

画像形式およびテキスト形式の、クレジットのHTMLソースを下記よりコピーして、アプリケーションやサイト上に掲載してください。

a.画像形式　小　155px × 20px

b.画像形式　中　100px × 35px

c.画像形式　大　150px × 50px

d.テキスト形式

■写真画像の利用

写真画像を利用する場合は、全ての写真の直下に「写真提供：ホットペッパー FooMoo 」を必ず記載してください。

写真提供：ホットペッパー FooMoo

エラーについて

■エラーコード

返される可能性のあるHTTPエラーコードは以下のとおりです。

コード	説明
400	Bad request. 渡されたパラメータがWebサービスで期待されたものと一致しない場合に返されます。このメッセージは何が間違っているか、何が正しくないかを伝えます。
403	Forbidden. リソースへのアクセスを許されていないか、利用制限を超えている場合に適用されます。
503	Webサービス内で問題が発生している場合に返されます。

■XML本文

各エラーにおいて、次の形式のXMLレスポンスを受け取ります。

<?xml version="1.0" encoding="UTF-8"?>
<Error xmlns="hapi">
<Message>API キーが見つかりません</Message>
</Error>

バージョンの管理について

■ホットペッパーWebサービスのバージョン

現在公開しているホットペッパー FooMooのWebサービスはベータ版です。
ホットペッパーWebサービスで提供されている各APIは、それぞれのXMLスキーマによって構造が決められているため、情報の活用がしやすいのですが、機能の修正や、新しい機能の追加によって、各APIの構造が変わる場合があります。
このような仕様変更があると、それまで各APIを利用して動いていたプログラムやアプリケーションは動かなくなってしまいますので、ご注意ください。 2007年11月より、APIキーとして、リクルートWebサービスのAPIキー[新規登録]が使えるようになりました。なお従来のguestも当面の間ご使用になれます。