・ オンラインドキュメント ・ 楽天ウェブサービス規約 ・ FAQ ・ APIステータス ・ クレジット表示 ・ ウェブサービスチームブログ ・ 旧ブログ ・ 楽天商品検索API ・ 楽天ジャンル検索API ・ 楽天商品コード検索API ・ 楽天商品ランキングAPI ・ 楽天プロダクト製品検索API ・ 楽天プロダクト製品詳細API ・ 楽天プロダクトジャンル情報API ・ 楽天プロダクトメーカー情報API ・ 楽天ブックス総合検索API ・ 楽天ブックス書籍API ・ 楽天ブックスCD検索API ・ 楽天ブックスDVD/Blu-ray検索API ・ 楽天ブックス洋書検索API ・ 楽天ブックス雑誌検索API ・ 楽天ブックスゲーム検索API ・ 楽天ブックスソフトウェア検索API ・ 楽天ブックスジャンル検索API ・ 楽天オークション商品検索API ・ 楽天オークション商品コード検索API ・ 楽天オークションジャンル検索API ・ 楽天トラベル施設検索API ・ 楽天トラベル施設情報API ・ 楽天トラベル空室検索API ・ 楽天トラベル地区コードAPI ・ 楽天トラベルキーワード検索API ・ 楽天トラベルホテルチェーンAPI ・ 楽天トラベルランキングAPI >> 楽天トラベル系APIサンプル集 ・ 楽天GORAゴルフ場検索API ・ 楽天GORAゴルフ場詳細API ・ 楽天GORAプラン検索API ・ 楽天ダイナミックアドAPI ・ 楽天ダイナミックアドAPI トラベル ・ 楽天アフィリエイト高料率ショップAPI

楽天トラベル施設検索API(SOAP開発用) (version:2007-11-21) ・リクエストURL ・インターフェース仕様 ・入力パラメーター ・出力パラメーター ・アフィリエイトに関して ・エラー   アカウント情報 ・ デベロッパーIDの確認 ・ アフィリエイトIDの確認 ■リクエストURL http://api.rakuten.co.jp/rws/soap/SimpleHotelSearch/2007-11-21 ※ リクエストURLは取得するデータ種別にかかわらず、すべて同じです。 ■インターフェース仕様 SOAPでは、インタフェース仕様はWSDLによって定義されます。下記のWSDLを参照してください。 http://api.rakuten.co.jp/rws/soap/SimpleHotelSearch/2007-11-21?wsdl ■入力パラメーター 楽天トラベル施設検索API（SimpleHotelSearch) SOAP用入力パラメーター version:2007-11-21 区分 ID 項目名 フィールド名 型 必須 デフォルト 備考 共 通 パ ラ メ | タ | 1 デベロッパID developerId String ○ --- デベロッパーID 2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID サ | ビ ス 固 有 パ ラ メ | タ | 1 バージョン apiVersion String ○ --- 1.11 2 大区分コード largeClassCode String ○ (*1) (*2) --- 国などを示すコード。地区コード一覧は地区コードAPI（GetAreaClass) より取得してください。 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 (*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。 3 中区分コード middleClassCode String ○ (*1) (*2) --- 都道府県などを示すコード。コード一覧は地区コードAPI（GetAreaClass) より取得してください。 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 (*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。 4 小区分コード smallClassCode String ○ (*1) (*2) --- 市など示すコード。コード一覧は地区コードAPI（GetAreaClass) より取得してください。 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 (*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。 5 細区分コード detailClassCode String ○ (*1) (*2) --- 駅や詳細地域などを示すコード。コード一覧は地区コードAPI（GetAreaClass) より取得してください。 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 (*2)地区コード一覧において子の区分が存在する場合、必ず子の区分まで指定する必要があります。 6 施設番号 hotelNo String ○ (*1) --- 楽天トラベルにおける施設を特定するためのNo (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 このフィールドは複数指定することができます。 例）12345,54321 7 緯度 latitude String ○ (*1) --- 日本測地系（Tokyo Datum）、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。 例）128216.17 ただし、datumTypeに1を指定した場合は、 世界測地系、単位は度で指定すること。 例）35.6065914 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 8 経度 longitude String ○ (*1) --- 日本測地系（Tokyo Datum）、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。 例）503259.29 ただし、datumTypeに1を指定した場合は、 世界測地系、単位は度で指定すること。 例）139.7513225 (*1)区分コード、施設番号、緯度経度いずれかが指定されていることが必須です。複数指定された場合の優先順位は[施設番号＞緯度経度＞区分コード]となります。 9 検索半径 searchRadius String - 1 緯度経度検索時の検索半径(単位km) 0.1以上、3.0以下であり、小数点以下は１桁までであること 10 絞込み条件 squeezeCondition String - --- kinen：禁煙ルーム internet：インターネットが出来る部屋 daiyoku：大浴場あり onsen：温泉 このフィールドは複数指定することができます。 例）禁煙ルームのある温泉宿 &squeezeCondition=kinen,onsen 11 キャリア情報 carrier String - 0 PC用の情報を返すのか、モバイル用の情報を返すのかを選択 PC:0 mobile:1 12 取得件数 hits String - --- 取得件数を制限するパラメーター。 緯度経度での検索のみに適用し、指定された座標から近い順にソートした結果を返す。 13 緯度経度タイプ datumType String - 2 ＡＰＩで扱う(入力及び出力)緯度経度のタイプを指定する。 1：世界測地系、単位は度。 2：日本測地系、単位は秒。デフォルト値。 ▲上へ ■出力パラメーター 楽天トラベル施設検索API（SimpleHotelSearch) SOAP用出力パラメーター version:2007-11-21 区分 ID 分類 項目名 型 フィールド名 備考 共 通 パ ラ メ | タ | 1 arg --- String User-Agent Valueにはユーザのユーザエージェントが表示される 2 --- String developerId ValueにはデベロッパーIDが表示される 3 --- String affiliateId Valueにはユーザの指定したアフィリエイトIDが表示される 4 --- String operation Valueにはユーザの指定した操作名が表示される 5 --- String apiVersion Valueにはユーザの指定した楽天ウェブサービスのバージョンが表示される 6 --- String version Valueにはユーザの指定した操作のバージョンが表示される 7 status --- String Status Success / NotFound / ServerError / ClientError / Maintenance のいずれか 8 statusMsg --- String StatusMsg Statusに特化したメッセージを出力 サ | ビ ス 固 有 パ ラ メ | タ | 1   検索半径 decimal searchRadius 緯度経度検索時の検索半径(単位km) (指定の半径で対象がない時は半径を大きくして検索する) 2 施設情報 ---   hotel   3 施設番号 integer hotelNo   4 施設名称 String hotelName   5 施設かな名称 String hotelKanaName   6 施設特色 String hotelSpecial   7 チェックイン時刻 String checkinTime HH:MM 8 チェックアウト時刻 String checkoutTime HH:MM 9 緯度 decimal latitude datumType=1の場合：世界測地系（WGS）、単位は度 datumType=2の場合：日本測地系（Tokyo Datum）、単位は秒、小数点以下がミリ秒 10 経度 decimal longitude datumType=1の場合：世界測地系（WGS）、単位は度 datumType=2の場合：日本測地系（Tokyo Datum）、単位は秒、小数点以下がミリ秒 11 郵便番号 String postalCode   12 住所１ String address1   13 住所２ String address2   14 施設電話番号 String telephoneNo   15 ファックス番号 String faxNo   16 施設へのアクセス String access   17 最寄駅名称 String nearestStationName   18 駐車場情報 String parkingInformation   19 ホテル種別コード String hotelClassCode   20 施設画像URL String hotelImageUrl   21 施設情報ページURL String hotelInformationUrl   22 施設情報ページアフィリエイトURL String hotelAffiliateUrl 入力パラメータのキャリア情報がPC(0)で、 なおかつアフィリエイトIDが含まれていた時のみ 23 宿泊予約センター電話番号 String reserveTelephoneNo 楽天価格での予約が電話で可能です。 ▲上へ ■アフィリエイトに関して デベロッパーは、楽天トラベル施設検索APIから取得した情報からアフィリエイトURLを作成することが可能です。リンク先にそのアフィリエイトURLを指定することで、楽天アフィリエイト経由の成果報酬を獲得することができます。 「アフィリエイトURL」は以下のルールで生成可能です。ただし、「施設情報ページURL」の部分はURLエンコードされている必要があります。（2007年12月現在、PCのみに対応。） 　 http://hb.afl.rakuten.co.jp/hgc/[アフィリエイトID]/?pc=[予約ページURL/施設情報ページURL（PC）] ▲上へ ■エラー エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。 Statusでの表示 内容 NotFound 検索結果が存在しない。 ServerError 楽天ウェブサービス側のエラー。 ClientError デベロッパーの入力に起因するエラー。 Maintenance メンテナンス。 ▲上へ

---

個人情報保護方針

Copyright (c) 1997-2012 Rakuten, Inc. All Rights Reserved.