ホテルAPI連携
RateHawk API連携：APIキーから本番のホテル予約まで
RateHawkのアカウントをPHPTRAVELSに接続し、RateHawkのホテルやアパートメントを自社のウェブサイトとエージェントポータルで販売できます。コネクターは用意済みです。APIキーを登録し、ホテルデータベースを取り込み、マークアップを設定して、RateHawkの認定を受けるだけです。
- 既製のRateHawkコネクター
- ETG API v3
- ホテルダンプの取り込み
- ネット料金に自社のマークアップ
サプライヤー
RateHawkとは何か、旅行会社が接続する理由
RateHawkは、Emerging Travel Group（ETG）が旅行代理店、ツアーオペレーター、旅行会社向けに提供するB2B予約プラットフォームです。パートナーは、RateHawk独自のポータルまたはAPIを通じて、ホテル、アパートメント、その他の宿泊施設をネット料金で予約できます。
このAPIはETG APIと呼ばれ、現行バージョンはv3です。JSONでリクエストとレスポンスをやり取りするREST APIで、検索、予約、キャンセルに対応しています。PHPTRAVELSは宿泊モジュールにRateHawkコネクターを搭載しているため、RateHawkの検索結果が他のホテルサプライヤーや自社契約の在庫と並んで表示されます。
- 会社
- RateHawk（Emerging Travel Group傘下）
- 種別
- 旅行業者向けB2B宿泊プラットフォーム
- 在庫
- RateHawkによると260万件以上の宿泊施設
- APIパートナー
- RateHawkによると700社以上のAPI顧客（2024年時点）
- API
- ETG API v3 · REST · JSON
- PHPTRAVELSでは
- 宿泊モジュールに既製のコネクター
ETG API v3の予約フロー
RateHawkの予約が進む流れをフェーズごとに
RateHawkの予約はすべて同じ5つのフェーズを経ます。各フェーズについて、その裏で使われるETG APIの呼び出しと、PHPTRAVELSが代わりに行う処理を示します。
- 01
検索
ETG APIの呼び出し
地域で検索 · 緯度経度で検索 · ホテルIDで検索
PHPTRAVELS
都市、地図上のエリア、ホテルリストで、日程、人数、旅行者の居住国を指定して検索し、マークアップを加えたリアルタイムのネット料金を表示します。
- 02
ホテルページ
ETG APIの呼び出し
ホテルページの取得
PHPTRAVELS
選択したホテルのすべての客室と料金を読み込みます。食事プラン、税金、キャンセルポリシー、支払い方法も含みます。
- 03
事前予約
ETG APIの呼び出し
料金の事前予約 · 料金情報の取得
PHPTRAVELS
決済の直前に、選択した料金がその価格のまま予約可能かを確認し、変わっていればチェックアウトを止めます。
- 04
予約
ETG APIの呼び出し
予約処理の作成、開始、確認
PHPTRAVELS
予約を作成して宿泊者情報を送信し、確定するまでステータスを追跡して、RateHawkの注文IDを保存します。
- 05
予約後
ETG APIの呼び出し
予約の取得 · 予約のキャンセル · ステータスwebhook
PHPTRAVELS
バウチャーを送信し、管理画面と顧客アカウントに予約を表示し、料金のポリシーに沿ってキャンセルを処理します。
静的データ
RateHawkのホテルデータベースは一度取り込み、あとは最新に保つ
検索結果に含まれるのは料金だけです。ホテル名、住所、写真、設備、説明はETGの静的データから取得し、PHPTRAVELSがホテルページに取り込みます。
地域ダンプ
国、都市、エリアのデータ。旅行者が目的地で検索できるようにします。
ホテルダンプ
ホテルコンテンツの完全なファイル：名称、住所、座標、写真、設備、説明。
差分ダンプ
前回の取り込み以降に変更された分だけを含み、全件を再読み込みせずにカタログを最新に保ちます。
レビューダンプ
ホテルページに表示する宿泊者のレビュー評価と本文。契約に含まれている場合に利用できます。
- 地域ダンプ100%
- ホテルダンプ100%
- 差分ダンプ64%
- レビューダンプ30%
サンプル画面です。件数はアカウントと言語によって異なります。
ETGはダンプファイルに加えて、ホテルデータを必要に応じて取得できるContent APIも提供しています。
APIキーとサンドボックス
RateHawk APIの認証の仕組み
ETG APIはHTTP Basic認証を使用します。キーIDがユーザー名、APIキーがパスワードとなり、すべてのリクエストでHTTPS経由で送信されます。
1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3 -H "Content-Type: application/json" \ 4 https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5 -d '{ 6 "checkin": "2026-11-14", 7 "checkout": "2026-11-16", 8 "residency": "gb", 9 "language": "en",10 "currency": "USD",11 "guests": [{ "adults": 2, "children": [] }],12 "hids": [8473727]13 }'1415# 8473727 = the test hotel: a real booking if you book it
- 2つのホスト
- サンドボックス：api-sandbox.ratehawk.com。テストと本番：api.ratehawk.com。旧worldota.netのホストは非推奨です。
- テストホテルは実在する
- テストキーで予約できるのはhid 8473727のテストホテルだけですが、その予約は実際の予約で、実際の金銭的責任が生じます。テスト後はすぐにキャンセルしてください。
- キーはサーバーに保管
- PHPTRAVELSはキーIDとAPIキーをサーバー設定に保管し、ブラウザやアプリには決して置きません。
- 居住国が重要
- 料金は旅行者の居住国によって変わるため、コネクターは検索のたびに居住国を送信します。
PHPTRAVELSでの設定
4ステップでRateHawkコネクターを設定
コードを書く必要はありません。コネクターは管理画面で設定します。
- 01APIキーを登録RateHawkから発行されたキーIDとAPIキーを貼り付けます。まずはサンドボックス用、後で本番用を登録します。
- 02ホテルデータベースを取り込む地域ダンプとホテルダンプを読み込み、差分更新をスケジュールします。
- 03マークアップと通貨を設定販売チャネル、エージェントグループ、目的地ごとに、割合または定額のマークアップを、販売する通貨で設定します。
- 04テストして本番へテスト予約とキャンセルを実行し、認定に合格したら本番キーに切り替えます。
環境
https://api-sandbox.ratehawk.comhttps://api.ratehawk.com
サンプルの設定画面です。
認定
契約から本番アクセスまで
RateHawkが本番環境を開放するのは、契約が締結され、連携が認定に合格した後です。
- 1
API契約を締結
お客様旅行会社としてRateHawkに連絡し、対象市場向けのAPI契約を締結します。
- 2
サンドボックスキーを受け取る
RateHawkRateHawkがサンドボックス用のキーIDとAPIキーを発行します。
- 3
接続と取り込み
PHPTRAVELSキーをPHPTRAVELSに登録し、静的データを取り込み、マークアップを設定します。
- 4
認定に合格
RateHawkRateHawkが、予約、ステータス、キャンセルのフローを含めて連携を確認します。
- 5
本番アクセス
お客様本番キーを管理画面に登録すると、実際の予約が始まります。
ポータル、API、エンジン
RateHawkのホテルを販売する3つの方法
エージェントは今すぐRateHawk独自のウェブサイトで予約できます。自社の予約エンジンに組み込んだAPIこそが、RateHawkのホテルを自社ブランドで販売可能にします。
RateHawkのウェブサイト
- 予約する人
- 自社のエージェントが1件ずつ予約
- ブランド
- RateHawk
- 必要な作業
- エージェントとして登録してログイン
自社でのAPI開発
- 予約する人
- 顧客とエージェントがオンラインで予約
- ブランド
- 自社
- 必要な作業
- 数か月の開発と認定
PHPTRAVELS＋RateHawk
- 予約する人
- 顧客とエージェントがオンラインで予約
- ブランド
- 自社
- 必要な作業
- 設定、コンテンツ取り込み、認定
マルチサプライヤー
他のホテルサプライヤーと並ぶRateHawk
RateHawkは宿泊モジュールのサプライヤーの1つです。同じ検索に他のホテルAPIや自社契約の在庫を含めることができ、サプライヤーごとにマークアップとルーティングを設定できます。
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
RateHawkはAPIアクセスの料金を公開していません。API契約を締結し、ネット料金に自社のマークアップを加えてホテルを販売します。費用となるのは、予約ソフトウェア、ホスティング、決済です。
旅行会社としてRateHawkに連絡し、API契約を締結します。その後RateHawkがサンドボックス用のキーIDとAPIキーを発行し、認定後に本番キーを発行します。
ETG APIのドキュメントはdocs.emergingtravel.comで公開されており、B2B API、Content API、サンドボックス、認定のガイドがあります。ダウンロード用の別のPDFはなく、オンラインのドキュメントが最新版です。
ETG APIは、RateHawkを運営するEmerging Travel GroupのAPIです。RateHawk API連携とETG API連携は同じ意味で、現行バージョンはv3です。
PHPTRAVELSは$2,499からの買い切りライセンスで、完全なソースコードが付属し、RateHawkコネクターは宿泊モジュールに含まれています。RateHawkとの商取引条件はRateHawkと直接合意します。
はい、api-sandbox.ratehawk.comにあります。テストキーで予約できるのはhid 8473727のテストホテルだけで、その予約は実際の予約なので、テスト後はすぐにキャンセルしてください。
エージェントがポータルで予約するには、ratehawk.comで登録してログインします。APIアクセスはそれとは別で、ポータルのログインではなく、契約に基づくキーIDとAPIキーを使用します。
コネクターはすでにあるため、時間がかかるのは開発ではなく、契約、キーの登録、ホテルコンテンツの取り込み、RateHawkの認定です。
はい。同じコネクターがB2CウェブサイトとB2Bエージェントポータルの両方に対応し、チャネルとエージェントグループごとに別々のマークアップを設定できます。
各料金にはキャンセルポリシーがあり、決済前に表示されます。キャンセルは管理画面または顧客アカウントから、そのポリシーに沿って予約キャンセルの呼び出しで実行されます。