เริ่มต้นใช้ REST API

REST API คือหัวใจของ Romnest — ให้คุณเชื่อมต่อการตรวจสอบห้องว่างและการจอง เข้ากับเว็บไซต์หรือแอปของคุณเองได้เต็มรูปแบบ

1. สร้าง API key

ไปที่ Settings → API Keys ในแผงควบคุมโรงแรม แล้วกด Create key คัดลอกค่าที่ได้เก็บไว้ให้ปลอดภัย (จะแสดงเต็มเพียงครั้งเดียว) คีย์ผูกกับโรงแรมของคุณโดยอัตโนมัติ

2. Base URL และการยืนยันตัวตน

ทุกคำขอใช้ฐาน URL นี้และส่งคีย์ผ่านส่วนหัว X-Api-Key

https://app.romnest.com/api/v1/partner/v1

3. ตรวจสอบห้องว่าง (อ่านข้อมูล — ใช้ได้ทุกแพ็ก)

curl "https://app.romnest.com/api/v1/partner/v1/availability?checkin=2026-07-01&checkout=2026-07-03&adults=2" \
  -H "X-Api-Key: YOUR_API_KEY"

จะได้รายการประเภทห้องที่ว่างพร้อมราคาสำหรับช่วงวันที่ที่ระบุ

4. สร้างการจอง (เขียนข้อมูล — ต้องแพ็ก Starter ขึ้นไป)

curl -X POST "https://app.romnest.com/api/v1/partner/v1/bookings" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-12345" \
  -d '{
    "roomTypeId": "...",
    "checkin": "2026-07-01",
    "checkout": "2026-07-03",
    "adults": 2,
    "guest": { "firstName": "สมชาย", "lastName": "ใจดี", "email": "[email protected]" }
  }'

ส่งส่วนหัว Idempotency-Key ที่ไม่ซ้ำกันในแต่ละคำสั่งซื้อ เพื่อกันการจองซ้ำเมื่อต้องลองใหม่

ขีดจำกัดการเรียกใช้ (rate limit) ต่อแพ็ก

| แพ็ก | สิทธิ์ | คำขอ/นาที | |------|--------|-----------| | Free | อ่านข้อมูลเท่านั้น | 120 | | Starter | อ่าน + สร้างการจอง | 1,200 | | Pro | อ่าน + สร้างการจอง | 12,000 |

เอกสารอ้างอิงฉบับเต็ม

ดู endpoint ทั้งหมด พารามิเตอร์ และสคีมาการตอบกลับได้ที่ เอกสาร API แบบ interactive (Redoc)