เชื่อมต่อซอฟต์แวร์ของคุณเข้ากับโมดูล HMS
เอกสาร API แยกสำหรับทุกโมดูลของซอฟต์แวร์โรงแรม ได้แก่ ระบบจองห้องพัก Wi-Fi ผู้เข้าพัก POS ร้านอาหาร สปา ทีวี ตู้สาขา และบริการ AI ขณะนี้ Online Booking API และ Hotspot API พร้อมใช้งานแล้ว ส่วนโมดูลอื่นจะตามมา
- การยืนยันตัวตน
Bearertoken หรือ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 ระบบจองห้องพัก
เชื่อมต่อระบบจองห้องพัก (booking engine) บนเว็บไซต์ของโรงแรมเข้ากับ HMS: รายการห้องพักและราคา ห้องว่างตามปฏิทิน คูปอง การชำระเงิน และการส่งการจอง
Hotspot
Wi-Fi ผู้เข้าพักและบันทึกตามกฎหมาย 5651
ส่งรายชื่อผู้เข้าพักในโรงแรมไปยังระบบ Hotspot ได้แก่ ห้องพัก ข้อมูลระบุตัวตน เวลาเช็กอินและเช็กเอาต์ ใช้สำหรับยืนยันการเข้าสู่ระบบ Wi-Fi ของผู้เข้าพักด้วยหมายเลขห้อง และเก็บบันทึกการเข้าใช้งานตามกฎหมายตุรกีฉบับที่ 5651
POS ร้านอาหาร
บิลและการชาร์จเข้าห้อง
ส่งบิลของร้านอาหาร บาร์ และคาเฟ่เข้าโฟลิโอของห้องพัก พร้อมซิงค์เมนูและสต็อก
Spa
การนัดหมายและบริการ
การนัดหมายสปาและเวลเนส แคตตาล็อกบริการ และการเชื่อมต่อการชาร์จเข้าห้อง
AI
บริการผู้ช่วยและระบบแนะนำ
เข้าถึงบริการ AI สำหรับผู้ช่วยของผู้เข้าพัก การแนะนำราคา และการออกรายงาน
TV
ระบบทีวีในห้องพัก
ข้อมูลผู้เข้าพัก โฟลิโอ ข้อความ และคำขอบริการสำหรับหน้าจอทีวีในห้องพัก
ตู้สาขา
ตู้สาขาและบันทึกการโทร
การเชื่อมต่อตู้สาขา (PBX): เปิดและปิดสายโทรศัพท์เมื่อเช็กอิน/เช็กเอาต์ และลงค่าโทรศัพท์เข้าโฟลิโอ
หลักการที่ใช้ร่วมกันในทุกผลิตภัณฑ์
เมื่อเชื่อมต่อโมดูลหนึ่งแล้ว โมดูลอื่น ๆ ก็จะดูคุ้นเคย
คีย์ที่ผูกกับโรงแรม
ใน Online Booking จะนำ apiKey/apiSecret ที่ HMS ออกให้ไปแลกเป็น Bearer token ที่ผูกกับโรงแรมและมีอายุ 7 วัน ส่วนการเชื่อมต่อภายในโรงแรม (on-premise) อย่าง Hotspot จะใช้คีย์ที่สร้างในแผงควบคุมของโรงแรมเอง และส่งในเฮดเดอร์ ApiKey ทุกคำขอ
โครงสร้าง success
การตอบกลับเป็น JSON และมีแฟล็ก success ข้อผิดพลาดตามกฎทางธุรกิจจะส่งกลับเป็น HTTP 200 พร้อม message หรือ errorCode ส่วนข้อผิดพลาดในการยืนยันตัวตนจะเป็น 401
ตัวอย่างที่ใช้งานได้จริง
มีตัวอย่าง cURL, Node.js และ PHP สำหรับทุกเอนด์พอยต์ เพียงคัดลอก ใส่คีย์ของคุณ แล้วรันได้ทันที
เอกสารอ้างอิง APIการเปลี่ยนแปลงล่าสุด
-
รองรับ 22 ภาษาใหม่ใหม่
-
เผยแพร่เอกสาร Hotspot API แล้วใหม่ใหม่
-
เผยแพร่เอกสาร Online Booking API แล้วใหม่ใหม่ใหม่
ติดปัญหาหรือไม่
ทีมนักพัฒนาของเราจะตอบกลับภายในหนึ่งวันทำการ
แนบเนื้อหาคำขอ (ปิดบังข้อมูลลับและข้อมูลบัตร) การตอบกลับ และเวลาที่ส่ง ใช้อีเมลเดียวกันนี้สำหรับขอคีย์พาร์ทเนอร์ โรงแรมทดสอบ และสิทธิ์เข้าใช้งานก่อนเปิดตัว