じゃらんWebサービス／ガイドライン

利用制限について

IPアドレスでの利用制限

サーバーへの負荷が一時的に高くなりすぎるのを避けるため、ある決められた短い時間のなかで、各IPアドレスのリクエスト数に制限を設けています。
制限の上限を超えた場合は、一定時間ロックがかかりますので、リクエストが再び利用できるようになるまでしばらくお待ちください。
また、利用制限の条件に関しては、公開していません。

利用制限の上限に達した場合

リクエストの頻度が利用制限の上限を超えた場合、APIへのリクエストに対して下記のXMLレスポンスが返されます。

APIキー「guest」の利用期限

APIキーの「guest」は、2006 年 9 月 30 日 PM 11:59をもって利用期限が終了いたしました。
まだ「guest」を使用している場合は、アカウント登録より新しいキーを取得してご利用ください。

エラーについて

エラーメッセージおよびコード

API利用時に何か問題がある場合は、HTTPエラーコードとともにXMLエラーレスポンスを受けます。

エラーコード

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

XML本文

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

※XMLレスポンスが簡略化される場合

Internet Explorerの設定で「HTTPエラーメッセージを簡易表示する」にチェックが入っている場合、 XMLレスポンスではなく、ブラウザー側で簡易のエラーメッセージが出ることがあります。

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

じゃらんWebサービスのバージョン

じゃらんWebサービスでは、各APIをバージョン別に管理しています。
じゃらんWebサービスで提供されている各APIは、それぞれのXMLスキーマによって構造が決められているため、 情報の活用がしやすいのですが、機能の修正や、新しい機能の追加によって、各APIの構造が変わる場合があります。
このような仕様変更があると、それまで各APIを利用して動いていたプログラムやアプリケーションは動かなくなってしまいます。 これらを避けるため、バージョン別に管理しています。

クレジット表示について

じゃらんWebサービスでは、じゃらんWebサービスで提供されるAPIを利用して作成されたサイト・アプリケーションに、 簡単に表示できる画像形式とテキスト形式のクレジットを用意しています。

これらのクレジットは、アプリケーションやサイトが、じゃらんWebサービスの提供するAPIを利用していることを示すとともに、 その利用が「じゃらんWebサービスの利用規約」に従っていることを表します。
じゃらんWebサービスの提供するAPIを利用するすべてのアプリケーションやサイトには、クレジットを表示する必要があります。

クレジットを表示するときの注意

クレジットを表示する場合は、規定のHTMLソースを利用してください。 HTMLのソースの改変や、画像の改変が行われた場合などには、 じゃらんWebサービスが提供するAPIの利用を停止させていただく可能性があります。

クレジットの表示方法

1.クレジットの選択

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

	表示形式	クレジット
a	画像形式 ブルー　88px × 50px
b	画像形式 グレー　88px × 50px
c	テキスト形式	じゃらん Web サービス

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

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

a.画像形式　ブルー　88px × 50px

b.画像形式　グレー　88px × 50px

c.テキスト形式

じゃらん Web サービス

3.クレジットの表示位置

画像形式、テキスト形式にかかわらず、表示位置は自由ですが、 そのアプリケーションやサイトがじゃらんWebサービスの利用の上に制作されていることがわからなくなるような表示の仕方はできません。

じゃらんnetの定期メンテナンスについて

じゃらんnetでは、システムメンテナンスの為、下記時間帯において、以下のサービスが一時停止いたします。
ご迷惑おかけいたしますが、あらかじめご了承くださいますようお願いいたします。

定期メンテナンスのお知らせ

じゃらんnetでは、月一回の定期メンテナンスを実施しています。
メンテナンス中は、検索・予約・予約変更・キャンセル等、すべてのサービスが停止となり、じゃらんWebサービスにて提供しているAPIも停止いたします。
その際アクセスされた場合は、エラーのXMLを返却いたします。あらかじめ、ご了承ください。
詳しくはこちらをご確認ください。
https://www.jalan.net/jalan/doc/howto/maintenance.html