ホテル情報

予約エンジンのページの枠組みを構成するデータです。連絡先と所在地、ソーシャルメディアのリンク、フッターのテキスト(法的表記、ホテル紹介、アナリティクス/広告用スニペット)、予約確認メール用の SMTP 設定が含まれます。

連絡先#

GET/external/hotel/{hotelID}/contact/info

認証: Authorization: Bearer

パスパラメーター

hotelIDinteger必須
ホテル ID。

レスポンス

200 成功。

エラーレスポンス

  • 404 ホテルが見つかりません。
リクエスト
curl "https://test.hms.gen.tr/external/hotel/1000/contact/info" \
  -H "Authorization: Bearer $HMS_TOKEN"
レスポンス · 200
{
    "title": "Demo Otel",
    "phone": "+90 258 000 00 00",
    "cellPhone": "+90 555 000 00 00",
    "email": "[email protected]",
    "www": "https://www.demootel.com",
    "address": "Kumsal Cad. No: 12",
    "country": "Türkiye",
    "countryIng": "Turkey",
    "city": "Antalya",
    "district": "Muratpaşa",
    "latitude": "36.8841",
    "longitude": "30.7056"
}

ソーシャルメディアのリンク#

GET/external/online/social/media

認証: Authorization: Bearer

クエリパラメーター

hotelIDinteger必須
ホテル ID。
limitintegerデフォルト: 20
1ページあたりの件数。
pageintegerデフォルト: 1
ページ番号。
orderstring
id または -id

レスポンス

200 成功。

リクエスト
curl "https://test.hms.gen.tr/external/online/social/media?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"
レスポンス · 200
{
    "success": true,
    "count": 2,
    "items": [
        {
            "url": "https://www.instagram.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-instagram",
                "iconsvg": null
            }
        },
        {
            "url": "https://www.facebook.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-facebook",
                "iconsvg": null
            }
        }
    ]
}

メールサーバー設定#

GET/external/online/mail/host

認証: Authorization: Bearer

ホテルがオンライン予約の確認メール用に設定した SMTP 情報を返します。パスワードが含まれるため、サーバー側でのみ使用してください。

クエリパラメーター

hotelIDinteger必須
ホテル ID。

レスポンス

200 成功。

エラーレスポンス

  • 200 mail_host_is_not_found — SMTP が未設定。hotel_id_is_not_found
リクエスト
curl "https://test.hms.gen.tr/external/online/mail/host?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"
レスポンス · 200
{
    "success": true,
    "data": {
        "transport": "smtp",
        "encryption": "tls",
        "port": 587,
        "host": "smtp.demootel.com",
        "user": "[email protected]",
        "password": "********"
    }
}