พอร์ทัลนักพัฒนาซอฟต์แวร์โรงแรม HMS

เชื่อมต่อซอฟต์แวร์ของคุณเข้ากับโมดูล HMS

เอกสาร API แยกสำหรับทุกโมดูลของซอฟต์แวร์โรงแรม ได้แก่ ระบบจองห้องพัก Wi-Fi ผู้เข้าพัก POS ร้านอาหาร สปา ทีวี ตู้สาขา และบริการ AI ขณะนี้ Online Booking API และ Hotspot API พร้อมใช้งานแล้ว ส่วนโมดูลอื่นจะตามมา

การยืนยันตัวตน
Bearer token หรือ 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 ระบบจองห้องพัก

เชื่อมต่อระบบจองห้องพัก (booking engine) บนเว็บไซต์ของโรงแรมเข้ากับ HMS: รายการห้องพักและราคา ห้องว่างตามปฏิทิน คูปอง การชำระเงิน และการส่งการจอง

8 ทรัพยากร · 16 เอนด์พอยต์เอกสาร
พร้อมใช้งาน

Hotspot

Wi-Fi ผู้เข้าพักและบันทึกตามกฎหมาย 5651

ส่งรายชื่อผู้เข้าพักในโรงแรมไปยังระบบ Hotspot ได้แก่ ห้องพัก ข้อมูลระบุตัวตน เวลาเช็กอินและเช็กเอาต์ ใช้สำหรับยืนยันการเข้าสู่ระบบ Wi-Fi ของผู้เข้าพักด้วยหมายเลขห้อง และเก็บบันทึกการเข้าใช้งานตามกฎหมายตุรกีฉบับที่ 5651

1 ทรัพยากร · 1 เอนด์พอยต์เอกสาร
เร็ว ๆ นี้

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
    เผยแพร่เอกสาร Hotspot API แล้ว
    ใหม่ใหม่
  • Online Booking
    เผยแพร่เอกสาร Online Booking API แล้ว
    ใหม่ใหม่ใหม่

ติดปัญหาหรือไม่

ทีมนักพัฒนาของเราจะตอบกลับภายในหนึ่งวันทำการ

แนบเนื้อหาคำขอ (ปิดบังข้อมูลลับและข้อมูลบัตร) การตอบกลับ และเวลาที่ส่ง ใช้อีเมลเดียวกันนี้สำหรับขอคีย์พาร์ทเนอร์ โรงแรมทดสอบ และสิทธิ์เข้าใช้งานก่อนเปิดตัว