サポート
連携作業で行き詰まったことがあれば、開発チームまでご連絡ください。まずは製品のエラーコードページをご確認いただくことをおすすめします。ほとんどの疑問はそこで解決できます。
パートナーキー
アクセスには HMS が発行するパートナーアカウントが必要です。会社情報と連携予定のホテルをメールでお知らせください。テスト環境用の apiKey、apiSecret、ホテル ID をお送りします。
問題を報告する際に含める情報
- 製品とエンドポイント(例:Online Booking ·
POST /external/online/roomType) - リクエストボディとレスポンスの全文(
apiSecret、トークン、カード情報はマスク) - リクエストの送信日時(タイムゾーン付き)と
hotelID - 期待した結果と、問題が再現するかどうか
よくある質問
API を利用するには何が必要ですか?
HMS が発行するパートナーアカウント(apiKey / apiSecret)と、連携するホテルへのアクセス権が必要です。また、ホテル側で該当するモジュール(例:オンライン予約チャネル)が有効になっている必要があります。
テスト環境はありますか?
はい。このドキュメントの例はテスト環境(test.hms.gen.tr)を使用しています。開発用に、テスト環境のホテルレコードとパートナーキーを提供します。本番環境のアドレスとキーは、連携が承認された時点で発行されます。
401 が返ります。
トークンがない、期限切れ、Bearer プレフィックスがない、または別のホテルのトークンです。再ログインしてからリトライしてください。ログインで success: false が返る場合は message を確認してください。キーペアの誤りか、ホテルへのアクセス権がないことが原因です。
客室一覧が空、または roomCount が 0 です。
ホテルのオンラインチャネルが停止中(errorCode 10003)、販売可能な客室タイプがない(10004)、または日付・人数の制限に該当しています。roomCount が 0 の客室については、roomRestrictionMessage で理由(最低宿泊数、チェックイン不可、料金未設定)を確認できます。
予約を送信したのに管理パネルに表示されません。
BookingPushRS に Error が含まれていないか確認してください。Hotel registration not found on HMS. はホテルがオンラインチャネルに接続されていないことを、Could not register. は通常、roomTypeID / ratePlanID が不正か、日付に矛盾があることを示します。
ほかのモジュールの API はいつ公開されますか?
レストラン POS、Spa、AI、TV、PBX のドキュメントを順次追加しています。公開日は変更履歴でお知らせします。特定のモジュールへの先行アクセスをご希望の場合はご連絡ください。