JTB WEBサービス

ガイドライン

JTB　WEBサービスをご利用いただく場合には、JTB　WEBサービスの利用規約に加えて、このガイドラインが適用されます。本サービスを利用することによって、本ガイドラインの内容を承諾したものとみなします。

目次

• ・リンクについて
• ・データの更新頻度について
• ・利用制限について
• ・エラーについて
• ・バージョンの管理について
• ・クレジット表示について
• ・定期メンテナンスについて

リンクについて

利用者ソフトウェア上で当社の商品を紹介し、かつ当社内の当該商品のページにリンクを設ける目的でご利用いただけます。つきましては、下記以下のページへのリンクをご指定ください。
・http://www.jtbonline.jp/dom_yado/
・http://www.jtb.co.jp/webservice/api/
利用者がガイドライン等に従わない場合などには、JTB WEBサービスが提供するAPIの利用を停止させていただく可能性があります。

データの更新頻度について

データのキャッシュ

利用者は一般的に以下の期間であれば、データをキャッシュする目的で当社の知的財産を格納することができます。
・商品の価格情報、および販売可能情報：24時間
・その他の情報：3か月間

※理由のいかんを問わず、当社は利用者に対していつでも上記の当社の知的財産を削除するよう指示することができ、利用者は当社の指示に従うものとします。利用者が従わない場合、JTB WEBサービスが提供するAPIの利用を停止させていただく可能性があります。

データの更新頻度

利用者ソフトウェア上または利用者ソフトウェア内に価格情報または販売可能情報を表示する場合、情報を少なくとも1週間に1回、各APIから新たに取得した情報に刷新し、再表示しなければなりません。

データの取得日時表示

利用者は、1時間に1回以上データを更新しない場合は、価格情報または在庫情報等の情報に隣接した位置に更新時刻・日時を記載しなければなりません。その際、下記の免責事項を、価格情報または販売可能情報等の情報に隣接して掲載するか、ハイパーリンク等の方法で掲載しなければなりません。

利用制限について

APIキーでの利用制限

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

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

リクエストの頻度が利用制限の上限を超えた場合、 APIへのリクエストに対して下記のレスポンスの状態を示すコードが、レスポンスデータの先頭に付与されます。

エラーについて

エラーコード

API利用時に何か問題がある場合は、レスポンスの状態を示すコードが、レスポンスデータの先頭に付与されます。

コード

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

※エラーコードの取り扱いについて
設定をしない場合は、結果表示をモジュールに任せているため、エラーが発生した際、結果表示用の領域に当該の文字列を出力し、検索結果は表示しません。独自の処理を加える場合は、上記のエラー定義を判断し、適切に処理する必要があります。

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

JTB WEBサービスのバージョン

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

クレジット表示について

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

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

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

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

クレジットの表示方法

1.クレジットの選択

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

a	画像形式 88px × 35px
ｂ	画像形式 135px × 17px
ｃ	テキスト形式	WEB SERVICES BY JTB

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

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

a.画像形式 88px × 35px

<a href="http://www.jtb.co.jp/webservice/api/"><img src="http://www.jtb.co.jp/
webservice/api/images/jtblogo_88_35.gif" alt="WEB SERVICES BY JTB" title
="WEB SERVICES BY JTB" width="88" height="35" border="0"></a>

b.画像形式 135px × 17px

<a href="http://www.jtb.co.jp/webservice/api/"><img src="http://www.jtb.co.jp/
webservice/api/images/jtblogo_135_17.gif" alt="WEB SERVICES BY JTB" title=
"WEB SERVICES BY JTB" width="135" height="17" border="0"></a>

c.テキスト形式

WEB SERVICES BY JTB

<a href="http://www.jtb.co.jp/webservice/api/">WEB SERVICES BY JTB</a>

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

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

定期メンテナンスについて

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

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

毎月第4木曜日AM 2:30 〜 AM 6:59まで、システムメンテナンスのため、下記のサービスを停止させていただきます。
・JTB INFO CREWによるオンライン予約&決済・会員登録の利用停止
・JTBDirectによるオンライン予約&決済の停止
JTB WEBサービスで提供されているAPIは動きますが、リンク先が「メンテナンス中」となります。あらかじめご了承ください。

詳しくはこちらをご確認ください。
http://www.jtb.co.jp/service_interruption/

Copyright (C) JTB Corp. All rights reserved.