概要

Online Booking API は、ホテル公式サイトの予約エンジンを HMS ホテル管理システムに接続します。客室・料金一覧、カレンダーの空室状況、クーポンの検証、決済ステップ、HMS への予約送信は、すべてこの API を通じて行います。予約エンジンを開発する代理店や HMS パートナー向けに設計されています。

ベース URL#

すべてのエンドポイントは以下のベース URL の /external/… パス配下にあります。HTTPS のみ受け付けます。

https://test.hms.gen.tr

フローの全体像#

ログインで取得するトークンの有効期間は7日間で、1つのホテルに紐づきます。客室一覧は、ゲストが検索した日付と人数で販売可能な客室と料金を返します。ゲストが客室を選び、支払い方法が確定したら、予約を BookingPushRQ として HMS に書き込みます。各ステップは予約フローガイドで順を追って説明しています。

リソース#

共通ルール#

• ログイン以外のすべてのリクエストには Authorization: Bearer <token> ヘッダーを付けます。
• ほとんどの POST エンドポイントはフォームフィールド（application/x-www-form-urlencoded または multipart/form-data）を受け取ります。予約送信と決済開始は JSON ボディを受け取ります。どちらを使うかは各エンドポイントのリファレンスページに記載しています。
• レスポンスは success フラグを含む JSON です。ビジネスルールのエラーも HTTP 200 で返るため、結果はステータスコードではなく success で判定してください。
• 日付は YYYY-MM-DD、金額は小数点以下2桁の文字列（"965.00"）です。通貨はホテルのオンラインチャネル設定で決まります。
• hotelID パラメーターは、トークンが紐づくホテルと一致している必要があります。

バージョン#

このドキュメントは HMS API V2 を対象としています。新しいフィールドやエンドポイントは予告なく追加されることがあるため、未知のフィールドを無視するようにクライアントを実装してください。変更内容は変更履歴に掲載しています。

次のステップ#