開発者ポータルHMS ホテル管理システム

自社のソフトウェアを HMS モジュールに接続

ホテル管理システムのモジュールごとに個別の API ドキュメントを用意しています:予約エンジン、ゲスト Wi-Fi、レストラン POS、スパ、TV、PBX、AI サービス。Online Booking API と Hotspot API は公開中で、その他も順次公開します。

認証
Bearer トークンまたは ApiKey ヘッダー
形式
JSON レスポンス、success エンベロープ
公開中
製品 2 件 · エンドポイント 17 件
準備中
製品 5 件
リクエスト
# 客室・料金の照会
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
レスポンス · 200(抜粋)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "スタンダードルーム",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "朝食付き",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

製品

製品ごとに専用のドキュメント、API リファレンス、コードサンプルがあります。準備中の製品は、公開時に変更履歴でお知らせします。

公開中

Online Booking

予約エンジン API

ホテル公式サイトの予約エンジンを HMS に接続します。客室・料金一覧、カレンダーの空室状況、クーポン、決済、予約送信に対応します。

リソース 8 件 · エンドポイント 16 件ドキュメント
公開中

Hotspot

ゲスト Wi-Fi とトルコ法第5651号のログ記録

滞在中のゲスト一覧(部屋、身元情報、チェックイン・チェックアウト日時)をホットスポットシステムに提供します。部屋番号によるゲスト Wi-Fi ログインの認証と、トルコ法第5651号に基づくアクセスログの保存に使用します。

リソース 1 件 · エンドポイント 1 件ドキュメント
準備中

レストラン POS

伝票とルームチャージ

レストラン、バー、カフェの伝票の客室フォリオへの計上、メニューと在庫の同期。

ドキュメント準備中
準備中

Spa

施術予約とサービス販売

スパ・ウェルネスの施術予約、サービスカタログ、ルームチャージ連携。

ドキュメント準備中
準備中

AI

アシスタントとレコメンドサービス

ゲストアシスタント、料金レコメンド、レポート作成のための AI サービスへのアクセス。

ドキュメント準備中
準備中

TV

客室 TV システム

客室 TV インターフェース向けのゲスト情報、フォリオ、メッセージ、サービスリクエスト。

ドキュメント準備中
準備中

PBX

PBX と通話記録

PBX 連携:チェックイン/チェックアウト時の回線の開通・停止、通話料金のフォリオへの計上。

ドキュメント準備中

全製品に共通する原則

1つのモジュールを連携すれば、ほかのモジュールもすぐに扱えます。

ホテルに紐づくキー

Online Booking では、HMS が発行する apiKey/apiSecret を、ホテルに紐づく有効期間7日間の Bearer トークンと交換します。Hotspot のようなオンプレミス連携では、ホテル自身の管理パネルで発行したキーを、すべてのリクエストで ApiKey ヘッダーとして送信します。

認証

success エンベロープ

レスポンスは JSON で、success フラグを含みます。ビジネスルールのエラーは HTTP 200 で message または errorCode とともに返り、認証エラーは 401 になります。

リクエストとレスポンス

動作するサンプル

すべてのエンドポイントについて cURL、Node.js、PHP のサンプルを自動生成しています。コピーしてキーを設定すれば、そのまま実行できます。

API リファレンス
  • サイト
    22 言語に対応
    新規新規
  • Hotspot
    Hotspot API ドキュメントを公開
    新規新規
  • Online Booking
    Online Booking API ドキュメントを公開
    新規新規新規

お困りですか?

開発チームが1営業日以内に回答します。

リクエストボディ(シークレットとカード情報はマスク)、レスポンス、発生日時を添えてご連絡ください。パートナーキー、テスト用ホテル、先行アクセスのご依頼も同じアドレスで受け付けています。