Room Booking API (1.0)

Download OpenAPI specification:

API Support: [email protected] URL: https://bookingx.in.th License: MIT Terms of Service

นี่คือคู่มือ API สำหรับระบบการจองห้องพัก

Hotels

สร้างโรงแรมหรือที่พักใหม่

ลงทะเบียนโรงแรมหรือที่พักใหม่ และ ผูกอสังหาดังกล่าวกับผู้ที่สร้าง

Authorizations:

None

Request Body schema: application/json
required

Hotel input data

address	string
city	string
country_code	string
name	string

Responses

Request samples

Payload

Content type

application/json

{"address": "777 Suriwong",
"city": "Bangrak",
"country_code": "TH",
"name": "My Resort"
}

Response samples

201
400
401
403
500

Content type

application/json

{"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
}

ระงับการใช้งานโรงแรม

ใช้เพื่อปิดหรือระงับการให้บริการโรงแรมชั่วคราว

path Parameters

hotel_id

required

string

Hotel ID

Responses

Response samples

Content type

application/json

{"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
}

เปิดการใช้งานโรงแรมอีกครั้ง

ใช้เพื่อเปิดโรงแรมที่ถูกปิดไปแล้ว

path Parameters

hotel_id

required

string

Hotel ID

Responses

Response samples

Content type

application/json

{"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
}

โรงแรมทั้งหมดที่อยู่ในระบบ

ดึงข้อมูลโรงแรมทั้งหมดในระบบ

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
500

Content type

application/json

[{"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
}
]

แสดงเฉพาะโรงแรมของฉัน

ดึงข้อมูลโรงแรมที่ฉันสร้างและสามารถจัดการได้

Authorizations:

None

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
401
500

Content type

application/json

[{"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
}
]

Members

สร้างลูกค้ารายใหม่

สร้างผู้ใช้งานหรือลงทะเบียนผู้ใช้งานจากระบบของท่านในระบบของเรา

Authorizations:

None

Request Body schema: application/json
required

Member Information

email	string
external_id	string
external_system_id	string
first_name	string
last_name	string
phone_intl_code	string
phone_number	string

Responses

Request samples

Payload

Content type

application/json

{"email": "[email protected]",
"external_id": "ext-001",
"external_system_id": "550e8400-e29b-41d4-a716-446655440002",
"first_name": "John",
"last_name": "Doe",
"phone_intl_code": "66",
"phone_number": "0812345678"
}

Response samples

201
400
401
403
500

Content type

application/json

{"email": "[email protected]",
"external_id": "ext-001",
"external_system_id": "550e8400-e29b-41d4-a716-446655440002",
"first_name": "John",
"id": 1,
"last_name": "Doe",
"phone_intl_code": "66",
"phone_number": "0812345678"
}

ลิสต์สมาชิกทั้งหมด

ดึงรายการสมาชิกในระบบ (เฉพาะของผู้ใช้ที่ login)

Authorizations:

None

query Parameters

external_system_id	string External System ID (UUID)
page	integer Page number (default: 1)
limit	integer Items per page (default: 20, max: 100)

Responses

Response samples

200
400
401
403
500

Content type

application/json

{"created_at": "string",
"email": "string",
"external_id": "string",
"external_system_id": "string",
"first_name": "string",
"id": "string",
"last_name": "string",
"phone": "string",
"phone_intl_code": "string",
"user_id": "string"
}

FrontDeskOperation

กำหนดห้องไปยัง Booking

กำหนดห้องไปยัง Booking ที่พิจารณาชนิดห้องและคนเข้าพัก

Authorizations:

None

path Parameters

id

required

string

Booking UUID

Responses

Response samples

200
400
404
409
500

Content type

application/json

{"property1": "string",
"property2": "string"
}

เช็คอิน Check-in booking

บันทึกว่า Booking นี้มีการเช็คอินแล้ว

Authorizations:

None

path Parameters

id

required

string

Booking UUID

Responses

Response samples

200
400
404
409

Content type

application/json

{"property1": "string",
"property2": "string"
}

เช็คเอาท์ Booking

บันทึกว่า Booking นี้มีการเช็คเอาท์แล้วและปล่อยห้องว่าง

Authorizations:

None

path Parameters

id

required

string

Booking UUID

Responses

Response samples

200
404
409

Content type

application/json

{"property1": "string",
"property2": "string"
}

Bookings

สร้าง Booking ใหม่

สร้าง Booking ใหม่สำหรับห้อง และ โรงแรมที่มีสิทธิ์

Authorizations:

None

Request Body schema: application/json
required

Booking details

check_in	string
check_out	string
guest_name	string
hotel_id	string
member_id	string
quantity	integer
	Array of objects (dto.BookingRoomReq)
special_request	string

Responses

Request samples

Payload

Content type

application/json

{"check_in": "2025-04-10",
"check_out": "2025-04-12",
"guest_name": "John Doe",
"hotel_id": "550e8400-e29b-41d4-a716-446655440002",
"member_id": "550e8400-e29b-41d4-a716-446655440000",
"quantity": 0,
"rooms": [{"check_in": "string",
"check_out": "string",
"room_type_id": "0198e0bc-ed0c-7f37-9ccf-eac0e47e029a"
}
],
"special_request": "Pick Up at Turino Train Stn 13:00"
}

Response samples

201
400
401
404

Content type

application/json

{"check_in": "string",
"check_out": "string",
"created_at": "string",
"hotel_id": "string",
"id": "string",
"member_id": "string",
"rooms": [{"bookingID": "string",
"checkIn": "string",
"checkOut": "string",
"createdAt": "string",
"guestName": "string",
"id": "string",
"price": 0,
"quantity": 0,
"roomTypeID": "string",
"roomTypeName": "string",
"specialRequest": "string"
}
],
"status": "string",
"total_price": 0
}

แสดงรายการจองของโรงแรม

ดึงข้อมูลการจองทั้งหมดของโรงแรมที่ผู้ใช้งานเป็นเจ้าของ

Authorizations:

None

path Parameters

hotel_id

required

string

Hotel ID

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
401
500

Content type

application/json

[{"check_in": "string",
"check_out": "string",
"created_at": "string",
"hotel_id": "string",
"id": "string",
"member_id": "string",
"rooms": [{"bookingID": "string",
"checkIn": "string",
"checkOut": "string",
"createdAt": "string",
"guestName": "string",
"id": "string",
"price": 0,
"quantity": 0,
"roomTypeID": "string",
"roomTypeName": "string",
"specialRequest": "string"
}
],
"status": "string",
"total_price": 0
}
]

ยกเลิกการจอง

เปลี่ยนแปลงสถานะของ Booking จาก "pending" เป็น "cancelled"

Authorizations:

None

path Parameters

id required	integer Booking ID
hotel_id required	integer Hotel ID

Responses

Response samples

200
400
401
404

Content type

application/json

{"check_in": "string",
"check_out": "string",
"created_at": "string",
"hotel_id": "string",
"id": "string",
"member_id": "string",
"rooms": [{"bookingID": "string",
"checkIn": "string",
"checkOut": "string",
"createdAt": "string",
"guestName": "string",
"id": "string",
"price": 0,
"quantity": 0,
"roomTypeID": "string",
"roomTypeName": "string",
"specialRequest": "string"
}
],
"status": "string",
"total_price": 0
}

การยืนยันการจอง

เปลี่ยนสถานะ booking เป็น หลักจากได้รับการชำระเงินเรียบร้อยแล้ว

Authorizations:

None

path Parameters

id required	integer Booking ID
hotel_id required	integer Hotel ID

Responses

Response samples

200
400
401
404

Content type

application/json

{"check_in": "string",
"check_out": "string",
"created_at": "string",
"hotel_id": "string",
"id": "string",
"member_id": "string",
"rooms": [{"bookingID": "string",
"checkIn": "string",
"checkOut": "string",
"createdAt": "string",
"guestName": "string",
"id": "string",
"price": 0,
"quantity": 0,
"roomTypeID": "string",
"roomTypeName": "string",
"specialRequest": "string"
}
],
"status": "string",
"total_price": 0
}

แสดง Booking ทั้งหมดภายในโรงแรมที่กำหนด

แสดง Booking ทั้งหมดภายในโรงแรมที่กำหนด เฉพาะผู้ที่เป็นเจ้าของโรงแรมเท่านั้น

Authorizations:

None

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
401

Content type

application/json

[{"check_in": "string",
"check_out": "string",
"created_at": "string",
"hotel_id": "string",
"id": "string",
"member_id": "string",
"rooms": [{"bookingID": "string",
"checkIn": "string",
"checkOut": "string",
"createdAt": "string",
"guestName": "string",
"id": "string",
"price": 0,
"quantity": 0,
"roomTypeID": "string",
"roomTypeName": "string",
"specialRequest": "string"
}
],
"status": "string",
"total_price": 0
}
]

ExternalSystems

สร้าง External System

สร้าง External System แบบที่ใช้ authenticate user ผ่าน JWT

Request Body schema: application/json
required

External System Input

name

required

string

Responses

Request samples

Payload

Content type

application/json

{"name": "Hotel PMS"
}

Response samples

201
400
401
500

Content type

application/json

{"created_at": "2025-08-26T12:34:56Z",
"id": "9b9c1f8e-3f24-4f10-8a89-9a7c7a8d0e54",
"is_active": true,
"name": "Hotel PMS",
"user_id": "9b9c1f8e-3f24-4f10-8a89-9a7c7a8d0e54"
}

ระงับการใช้งาน External System

ระงับการใช้งาน External System สำหรับ API User ที่กำหนด

path Parameters

id

required

string <uuid>

Example: 019a0081-9bf1-71f3-bf3b-4a2e2a3c1234

ID UUID

Responses

Response samples

200
400
401
404
500

Content type

application/json

{ }

แสดง External Systems ตามเจ้าของ API User

แสดงรายการ External System ทั้งหมดของผู้ใช้ที่ล็อกอิน

Authorizations:

None

Responses

Response samples

200
401
500

Content type

application/json

[{"created_at": "2025-08-26T12:34:56Z",
"id": "9b9c1f8e-3f24-4f10-8a89-9a7c7a8d0e54",
"is_active": true,
"name": "Hotel PMS",
"user_id": "9b9c1f8e-3f24-4f10-8a89-9a7c7a8d0e54"
}
]

RoomManagement

ค้นหาห้องว่าง (Internal Testing Only)

ค้นหาห้องว่างทั้งหมดในโรงแรมที่กำหนด ตาม API User ที่คิวรี

Authorizations:

None

Request Body schema: application/json
required

Search criteria

check_in	string
check_out	string
hotel_id	integer
occupancy	integer

Responses

Request samples

Payload

Content type

application/json

{"check_in": "2026-02-01",
"check_out": "2026-02-05",
"hotel_id": 10,
"occupancy": 2
}

Response samples

200
400
401
403
500

Content type

application/json

[{"created_at": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_available": true,
"room_description": "string",
"room_number": "string",
"room_type": {"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
},
"room_type_id": "string"
}
]

เพิ่มราคาให้กับชนิดห้อง

กำหนดราคาสำหรับแต่ละชนิดห้องในโรงแรมที่พัก

path Parameters

hotel_id

required

string

Hotel ID

Request Body schema: application/json
required

Room Pricing Data

effective_date	string <date>
hotel_id	string
is_available	boolean
price	number
pricing_model	string
room_type_id	string

Responses

Request samples

Payload

Content type

application/json

{"effective_date": "2025-01-01T00:00:00Z",
"hotel_id": "0199282d-5625-794b-a4ba-d2dcffa22a1c",
"is_available": true,
"price": 1500,
"pricing_model": "Base Price",
"room_type_id": "0199282d-5625-794b-a4ba-d2dcffa22abb"
}

Response samples

201
400
401
403
500

Content type

application/json

{"created_at": "string",
"date": "string",
"hotel_id": "string",
"id": "string",
"is_available": true,
"price": 0,
"pricing_model": "string",
"room_type_id": "string"
}

เพิ่มราคาห้องเป็นช่วงวัน

เพิ่มราคาห้องเป็นช่วงวัน ตามโรงแรมที่กำหนด เพิ่มหลายวันต่อ 1 รายการ

path Parameters

hotel_id

required

string

Hotel ID

Request Body schema: application/json
required

Room Pricing Data (By Range)

end_date	string
hotel_id	string
is_available	boolean
price	number
pricing_model	string
room_type_id	string
start_date	string

Responses

Request samples

Payload

Content type

application/json

{"end_date": "2025-09-20",
"hotel_id": "0199282d-5625-794b-a4ba-d2dcffa22a1c",
"is_available": true,
"price": 1800,
"pricing_model": "Seasonal Price",
"room_type_id": "01992919-d772-7236-a94b-5018a45749b0",
"start_date": "2025-09-10"
}

Response samples

201
400
401
403
500

Content type

application/json

[{"created_at": "string",
"date": "string",
"hotel_id": "string",
"id": "string",
"is_available": true,
"price": 0,
"pricing_model": "string",
"room_type_id": "string"
}
]

สร้างชนิดห้องใหม่

สร้างชนิดห้องใหม่ ในโรงแรมที่กำหนด

Authorizations:

None

Request Body schema: application/json
required

Room Type Request

description	string
hotel_id required	string
is_active	boolean
room_type required	string

Responses

Request samples

Payload

Content type

application/json

{"description": "string",
"hotel_id": "string",
"is_active": true,
"room_type": "string"
}

Response samples

201
400
401
500

Content type

application/json

{"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
}

รายละเอียดห้อง

รายละเอียดห้อง ที่จะมีทั้งรูปแบบราคาและโรงแรมมาแสดงรวมกัน

Authorizations:

None

path Parameters

hotel_id required	string Hotel ID
room_id required	string Room ID

Responses

Response samples

200
401
403
404

Content type

application/json

{"effective_date": "string",
"hotel_name": "string",
"price": 0,
"pricing_model": "string",
"room_id": "string",
"room_number": "string",
"room_type": "string"
}

เปิดใช้ ชนิดราคาห้องอีกครั้ง

เปิดใช้ ชนิดราคาห้องอีกครั้ง ในโรงแกรมที่กำหนด

path Parameters

hotel_id required	string Hotel ID
id required	string RoomPricing ID

Responses

Response samples

200
404
500

Content type

application/json

{"created_at": "string",
"date": "string",
"hotel_id": "string",
"id": "string",
"is_available": true,
"price": 0,
"pricing_model": "string",
"room_type_id": "string"
}

ระงับการใช้งานราคาห้องพัก

ระงับราคาห้องพักตามหมายเลขโรงแรมและหมายเลขราคา

path Parameters

hotel_id required	string Hotel ID
pricing_id required	string Room Pricing ID

Responses

Response samples

Content type

application/json

{"created_at": "string",
"date": "string",
"hotel_id": "string",
"id": "string",
"is_available": true,
"price": 0,
"pricing_model": "string",
"room_type_id": "string"
}

แสดงระดับราคา

แสดงระดับราคา ตามโรงแรมและประเภทห้อง

query Parameters

hotel_id required	string Hotel ID
room_type_id required	string Room Type ID

Responses

Response samples

200
400
401
403
500

Content type

application/json

[{"created_at": "string",
"date": "string",
"hotel_id": "string",
"id": "string",
"is_available": true,
"price": 0,
"pricing_model": "string",
"room_type_id": "string"
}
]

แสดงชนิดห้อง

แสดงชนิดห้อง ตามโรงแรมที่กำหนด

path Parameters

hotel_id

required

string

Hotel ID

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
400
404

Content type

application/json

[{"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
}
]

เปิดใช้ ชนิดห้องอีกครั้ง

เปิดใช้ ชนิดห้องอีกครั้ง ในโรงแกรมที่กำหนด

path Parameters

hotel_id required	string Hotel ID
id required	string RoomType ID

Responses

Response samples

200
404
500

Content type

application/json

{"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
}

ระงับการใช้ประเภทห้องพัก

ระงับการใช้ประเภทห้องพัก ตามหมายเลขโรงแรมและหมายเลขประเภทห้อง

path Parameters

hotel_id required	string Hotel ID
room_type_id required	string Room Type ID

Responses

Response samples

Content type

application/json

{"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
}

เพิ่มห้องเข้าสู่โรงแรมที่พัก

เพิ่มห้องเข้าสู่โรงแรมที่พัก ตามหมายเลขโรงแรมที่กำหนด

Authorizations:

None

Request Body schema: application/json
required

Room input

is_available	boolean
max_occupancy	integer
room_number	string
room_type_id	string

Responses

Request samples

Payload

Content type

application/json

{"is_available": true,
"max_occupancy": 0,
"room_number": "string",
"room_type_id": "string"
}

Response samples

201
400
401
403
500

Content type

application/json

{"created_at": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_available": true,
"room_description": "string",
"room_number": "string",
"room_type": {"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
},
"room_type_id": "string"
}

แสดงห้องแต่ละโรงแรม

แสดงห้องแต่ละโรงแรม โดยการค้นหาตามหมายเลขโรงแรม

query Parameters

hotel_id required	string Hotel ID
page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
400
401
403
500

Content type

application/json

[{"created_at": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"name": "string",
"rating": 0,
"user_id": "string"
},
"id": "string",
"is_available": true,
"max_occupancy": 0,
"room_description": "string",
"room_number": "string",
"room_type": {"description": "string",
"id": "string",
"room_type": "string"
}
}
]

ระงับการใช้ห้อง

ระงับการใช้ห้อง ตามหมายเลขโรงแรมที่กำหนด

path Parameters

hotel_id required	string Hotel ID
room_id required	string Room ID

Responses

Response samples

Content type

application/json

{"created_at": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_available": true,
"room_description": "string",
"room_number": "string",
"room_type": {"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
},
"room_type_id": "string"
}

เปิดใช้ ห้องอีกครั้ง

เปิดใช้ ห้องอีกครั้ง ในโรงแกรมที่กำหนด

path Parameters

hotel_id required	string Hotel ID
room_id required	string Room ID

Responses

Response samples

200
404
500

Content type

application/json

{"created_at": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_available": true,
"room_description": "string",
"room_number": "string",
"room_type": {"created_at": "string",
"description": "string",
"hotel": {"address": "string",
"city": "string",
"country_code": "string",
"created_at": "string",
"id": "string",
"is_active": true,
"name": "string",
"rating": 0,
"user_id": "string"
},
"hotel_id": "string",
"id": "string",
"is_active": true,
"max_occupancy": 0,
"room_type": "string"
},
"room_type_id": "string"
}

Amenities

เพิ่ม Amenity

เพิ่ม Amenity ตามรายชื่อ hotel id ที่ระบุ

Authorizations:

None

Request Body schema: application/json
required

Amenity input data

name	string
room_type_id	string

Responses

Request samples

Payload

Content type

application/json

{"name": "Swimming Pool",
"room_type_id": "2b8c1fb1-8a12-4a22-99e1-bb7f0d9a9981"
}

Response samples

201
400
401
403
500

Content type

application/json

{"hotel_id": "string",
"id": "string",
"is_active": true,
"name": "string"
}

ลบ Amenity

ลบ Amenity ตามรายชื่อ user

Authorizations:

None

path Parameters

hotel_id required	string Hotel ID
id required	string Amenity ID

Responses

แสดง Amenities

แสดง Amenities ตาม hotel_id ที่ส่งเข้ามา query

Authorizations:

None

query Parameters

hotel_id required	string Hotel ID
page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=100 Items per page (default: 100)

Responses

Response samples

200
400
401
403
500

Content type

application/json

[{"hotel_id": "string",
"id": "string",
"is_active": true,
"name": "string"
}
]

FacilityManagement

เพิ่มสิ่งอำนวยความสะดวก

เพิ่มสิ่งอำนวยความสะดวกให้โรงแรมที่ระบุ

path Parameters

hotel_id

required

string

Hotel ID

Request Body schema: application/json
required

Facility details

is_active	boolean
name	string

Responses

Request samples

Payload

Content type

application/json

{"is_active": true,
"name": "Hair Dryer"
}

Response samples

201
400
401
403
500

Content type

application/json

{"created_at": "string",
"hotel_id": "string",
"id": "string",
"is_active": true,
"name": "string"
}

ระงับการใช้งานสิ่งอำนวยความสะดวก

ปิดการใช้งาน facility ตามรหัสที่ระบุ

path Parameters

hotel_id required	string Hotel ID
facility_id required	string Facility ID

Responses

เปิดใช้งานสิ่งอำนวยความสะดวก

เปิดใช้งาน facility ที่ถูกปิดไปก่อนหน้า

path Parameters

hotel_id required	string Hotel ID
facility_id required	string Facility ID

Responses

แสดง Facility รายโรงแรม

ดึงรายการ Facility ของโรงแรม (เฉพาะเจ้าของโรงแรมเท่านั้น)

Authorizations:

None

path Parameters

hotel_id

required

string

Hotel ID (UUID)

query Parameters

page	integer Page number (default: 1)
limit	integer Items per page (default: 20, max: 100)

Responses

Response samples

200
400
401
403
500

Content type

application/json

{"data": [{"created_at": "string",
"hotel_id": "string",
"id": "string",
"is_active": true,
"name": "string"
}
],
"pagination": {"limit": 20,
"page": 1,
"total": 5,
"total_page": 1
}
}

ImageManagement

ลิสต์รูป facility โรงแรม

แสดงรายการภาพสิ่งอำนวยความสะดวกของโรงแรม

path Parameters

hotel_id

required

string

Hotel UUID

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
400
404
500

Content type

application/json

[{"created_at": "string",
"host_prefix": "string",
"hotel_id": "string",
"id": "string",
"is_active": true,
"object_path": "string"
}
]

อัพโหลดภาพ facility ของโรงแรม

อัพโหลดภาพสิ่งอำนวยความสะดวกในโรงแรม เป็น .jpg .jpeg .png โดยมีขนาดไม่เกิน 2MB

path Parameters

hotel_id

required

string

Hotel UUID

Request Body schema: multipart/form-data
required

file

required

string <binary>

อัพโหลดไฟล์เฉพาะ .png .jpg หรือ .jpeg

Responses

Response samples

201
400
404
500

Content type

application/json

{"host_prefix": "https://public-s3.avesta.top",
"hotel_id": "019b9bc0-5a6a-7153-b62d-b11a49ee81f8",
"image_id": "019c1a22-7b44-7f12-a0b9-3dca12345678",
"path": "/pms-images/019b9bc0/019c1a22.jpg"
}

อัพโหลดรูปของสถานประกอบการ

อัพโหลดรูปภาพรวม หรือ รูปทั่วไปของสถานประกอบการ เป็น .jpg .jpeg .png โดยมีขนาดไม่เกิน 2MB

path Parameters

hotel_id

required

string

Hotel UUID

Request Body schema: multipart/form-data
required

file

required

string <binary>

อัพโหลดไฟล์เฉพาะ .png .jpg หรือ .jpeg

Responses

Response samples

201
400
404
500

Content type

application/json

{"host_prefix": "https://public-s3.avesta.top",
"hotel_id": "019b9bc0-5a6a-7153-b62d-b11a49ee81f8",
"image_id": "019c1a22-7b44-7f12-a0b9-3dca12345678",
"path": "/pms-images/019b9bc0/019c1a22.jpg"
}

อัพโหลดภาพของแต่ละชนิดห้อง

อัพโหลดภาพของแต่ละชนิดห้อง เป็น .jpg .jpeg .png โดยมีขนาดไม่เกิน 2MB

path Parameters

hotel_id required	string Hotel UUID
id required	string Room Type UUID

Request Body schema: multipart/form-data
required

file

required

string <binary>

อัพโหลดไฟล์เฉพาะ .png .jpg หรือ .jpeg

Responses

Response samples

201
400
404
500

Content type

application/json

{"host_prefix": "https://public-s3.avesta.top",
"hotel_id": "019b9bc0-5a6a-7153-b62d-b11a49ee81f8",
"image_id": "019c1a22-7b44-7f12-a0b9-3dca12345678",
"path": "/pms-images/019b9bc0/019c1a22.jpg",
"room_type_id": "019b9bc0-5a6a-7153-b62d-b11a49ee81f8"
}

ลิสต์รูปของแต่ละชนิดห้อง

แสดงรายการภาพของชนิดห้อง

path Parameters

hotel_id required	string Hotel UUID
id required	string Room Type UUID

query Parameters

page	integer Example: page=1 Page number (default: 1)
limit	integer Example: limit=20 Items per page (default: 20)

Responses

Response samples

200
400
404
500

Content type

application/json

[{"created_at": "string",
"host_prefix": "string",
"hotel_id": "string",
"id": "string",
"is_active": true,
"object_path": "string",
"room_type_id": "string"
}
]

RoomSearch

ค้นหาห้องว่าง

ค้นหาห้องว่างและแสดง แต่ละมาตรฐานราคา สำหรับโรงแรมที่พักที่กำหนด

Authorizations:

None

query Parameters

hotel_id required	string Example: hotel_id=0199282d-5625-794b-a4ba-d2dcffa22a1c Hotel ID
start_date required	string Example: start_date=2025-09-09 Start date in YYYY-MM-DD format, default today
end_date required	string Example: end_date=2025-09-12 End date in YYYY-MM-DD format, default same as start_date
guests required	integer Example: guests=2 Number of guests (compared with room_type.max_occupancy)

Responses

Response samples

200
400
401
403
500

Content type

application/json

[{"count": 5,
"price": 1500,
"pricing_model": "standard",
"room_type": "Deluxe"
}
]

Authentication

ตรวจสอบสิทธิ์

ตรวจสอบสิทธิ์ และ คืน token สำหรับการทำงาน

Request Body schema: application/json
required

User credentials

password	string
username	string

Responses

Request samples

Payload

Content type

application/json

{"password": "123456",
"username": "john"
}

Response samples

200
400
401

Content type

application/json

{"token": "eyJhbGciOiJI..."
}

รีเฟรส JWT token

ใช้รีเฟรสโทเค็นส่งเข้ามาเพื่อจะรับ access token อันใหม่ไป ซึ่งมีเวลา 1 สัปดาห์

Request Body schema: application/json
required

Refresh token payload

refresh_token

string

Responses

Request samples

Payload

Content type

application/json

{"refresh_token": "8f14e45f-ea9f-4c72-abc1-92c98f2398aa"
}

Response samples

200
400
401

Content type

application/json

{"property1": "string",
"property2": "string"
}

Room Booking API (1.0)

Hotels

สร้างโรงแรมหรือที่พักใหม่

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

ระงับการใช้งานโรงแรม

path Parameters

Responses

Response samples

เปิดการใช้งานโรงแรมอีกครั้ง

path Parameters

Responses

Response samples

โรงแรมทั้งหมดที่อยู่ในระบบ

query Parameters

Responses

Response samples

แสดงเฉพาะโรงแรมของฉัน

Authorizations:

query Parameters

Responses

Response samples

Members

สร้างลูกค้ารายใหม่

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

ลิสต์สมาชิกทั้งหมด

Authorizations:

query Parameters

Responses

Response samples

FrontDeskOperation

กำหนดห้องไปยัง Booking

Authorizations:

path Parameters

Responses

Response samples

เช็คอิน Check-in booking

Authorizations:

path Parameters

Responses

Response samples

เช็คเอาท์ Booking

Authorizations:

path Parameters

Responses

Response samples

Bookings

สร้าง Booking ใหม่

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

แสดงรายการจองของโรงแรม

Authorizations:

path Parameters

query Parameters

Responses

Response samples

ยกเลิกการจอง

Authorizations:

path Parameters

Responses

Response samples

การยืนยันการจอง

Authorizations:

path Parameters

Responses

Response samples

แสดง Booking ทั้งหมดภายในโรงแรมที่กำหนด

Authorizations:

query Parameters

Responses

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required