じゃらん 宿・ホテル予約サイト
 じゃらんnetトップ じゃらんnetのご利用方法 ご要望・お問合せ
宿・ホテル予約TOP > じゃらんWebサービス > ガイドライン

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

APIリファレンス

目次

利用制限について

IPアドレスでの利用制限

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

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

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

<?xml version="1.0" encoding="UTF-8" ?>
<Error xmlns="jws">
  <Message>アクセスが拒否されました。</Message>
</Error>

APIキー「guest」の利用期限

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

エラーについて

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

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

エラーコード

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

コード説明
400 パラメーターの値が不正な場合や、想定されていないパラメーターなど渡されたパラメーターがWebサービスで期待されたものと一致しない場合に返されます。
このメッセージは何が間違っているか、何が正しくないかを伝えます。
403 利用制限に反した場合に返されます。
406 APIに同時アクセス可能なユーザ数が制限を超えた場合に返されます。
503 Webサービス内で問題が発生している場合に返されます。

XML本文

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

<?xml version="1.0" encoding="UTF-8" ?>
<Error xmlns="jws">
  <Message>エラーメッセージ</Message>
</Error>

※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
じゃらん WEB SERVICE
b 画像形式
グレー 88px × 50px
じゃらん WEB SERVICE
c テキスト形式 じゃらん Web サービス

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

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

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

じゃらん WEB SERVICE

<a href="http://www.jalan.net/jw/jwp0000/jww0001.do"><img src="http://www.jalan.net/jalan/doc/jws/images/jws_88_50_blue.gif" alt="じゃらん Web サービス" title="じゃらん Web サービス" border="0"></a>
b.画像形式 グレー 88px × 50px

じゃらん WEB SERVICE

<a href="http://www.jalan.net/jw/jwp0000/jww0001.do"><img src="http://www.jalan.net/jalan/doc/jws/images/jws_88_50_gray.gif" alt="じゃらん Web サービス" title="じゃらん Web サービス" border="0"></a>
c.テキスト形式

じゃらん Web サービス

<a href="http://www.jalan.net/jw/jwp0000/jww0001.do">じゃらん Web サービス</a>

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

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

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

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

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

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


ビジネスホテル高級ホテル温泉・露天風呂ペットとホテル宿・ホテル一覧レンタカーツアー航空券高速バス・夜行バス旅行・観光ガイド