自社のソフトウェアを 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"# 滞在中のゲスト一覧
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}製品
製品ごとに専用のドキュメント、API リファレンス、コードサンプルがあります。準備中の製品は、公開時に変更履歴でお知らせします。
Online Booking
予約エンジン API
ホテル公式サイトの予約エンジンを HMS に接続します。客室・料金一覧、カレンダーの空室状況、クーポン、決済、予約送信に対応します。
Hotspot
ゲスト Wi-Fi とトルコ法第5651号のログ記録
滞在中のゲスト一覧(部屋、身元情報、チェックイン・チェックアウト日時)をホットスポットシステムに提供します。部屋番号によるゲスト Wi-Fi ログインの認証と、トルコ法第5651号に基づくアクセスログの保存に使用します。
レストラン 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 になります。
最近の変更
-
22 言語に対応新規新規
-
Hotspot API ドキュメントを公開新規新規
-
Online Booking API ドキュメントを公開新規新規新規
お困りですか?
開発チームが1営業日以内に回答します。
リクエストボディ(シークレットとカード情報はマスク)、レスポンス、発生日時を添えてご連絡ください。パートナーキー、テスト用ホテル、先行アクセスのご依頼も同じアドレスで受け付けています。