REST API

Tích hợp hệ thống của bạn với REST API

Có quyền truy cập đầy đủ vào dữ liệu đặt phòng, khách, và phòng thông qua REST API của chúng tôi. Tự động hóa quy trình và tích hợp lịch-di động với các hệ thống riêng của bạn.

GET /v1/public/reservations
Authorization: Bearer {access_token}

{
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792
  },
  "meta": {
    "ruid": "7f80f1b4-a44b-4345-b383-7d0a937b4411"
  }
}
Khả năng

API Toàn diện cho Doanh nghiệp của bạn

API REST của chúng tôi cung cấp quyền truy cập đầy đủ vào tất cả các tính năng của hệ thống, cho phép tạo các tích hợp tùy chỉnh và tự động hóa.

Các thao tác CRUD

Toàn quyền kiểm soát dữ liệu - tạo, đọc, cập nhật và xóa bản ghi thông qua các yêu cầu HTTP tiêu chuẩn.

  • Quản lý Đặt phòng
  • Dữ liệu khách hàng
  • Cấu hình Phòng
  • Hóa đơn và thanh toán
Webhooks Thời Gian Thực

Nhận thông báo tức thì về các thay đổi của hệ thống trực tiếp trên máy chủ của bạn.

  • Thông báo thời gian thực
  • Phạm vi sự kiện có thể cấu hình
  • Kết nối HTTPS an toàn
  • Tự động thử lại
Bảng Nhật Ký Nhà Phát Triển

Giám sát tất cả các yêu cầu API và gỡ lỗi tích hợp trực tiếp trong ứng dụng.

  • Lịch Sử Yêu Cầu API
  • Phản hồi đầy đủ từ máy chủ
  • Chi tiết lỗi
  • Lịch sử 30 ngày
Điểm cuối

Truy cập vào tất cả dữ liệu

API cung cấp các điểm cuối cho tất cả các tài nguyên hệ thống chính. Tài liệu chi tiết với các ví dụ có sẵn trực tuyến.

Xem tài liệu
  • /reservations

    Tải xuống, tạo và chỉnh sửa đặt phòng. Truy cập toàn bộ lịch sử và trạng thái.

  • /guests

    Quản lý cơ sở dữ liệu khách, thông tin liên hệ và lịch sử lưu trú.

  • /rooms

    Cấu hình phòng, tình trạng phòng, giá và các tính năng tiện nghi.

  • /invoices

    Tạo hóa đơn, theo dõi thanh toán, và quản lý tài liệu.

POST Webhook Event
{
  "webhookId": "9b9b499e-095c-4955-8dd0-cc5d84e50764",
  "eventType": "reservation.created",
  "timestamp": "2025-10-10T15:39:07+02:00",
  "data": {
    "type": "SINGLE",
    "reservationId": [478652],
    "roomId": [28568],
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792,
    "triggeredBy": "MANUAL"
  }
}
Webhooks

Thông báo theo thời gian thực

Webhook cho phép các phản ứng tự động với các sự kiện trong hệ thống. Cấu hình URL điểm cuối và nhận thông báo về các đặt phòng mới, thay đổi, và hủy bỏ.

  • reservation.created - đặt phòng mới
  • reservation.updated - cập nhật đặt phòng
  • reservation.cancelled - hủy đặt phòng
  • đặt_chỗ.đã_nhận_phòng - nhận phòng khách
Tìm hiểu thêm về webhooks

REST API khả dụng trong gói Premium

Quyền truy cập vào REST API, webhooks, và bảng điều khiển nhật ký nhà phát triển là một phần của gói Premium. Có quyền kiểm soát hoàn toàn các tích hợp của tài sản của bạn.

REST API FAQ

Câu hỏi thường gặp

Không tìm thấy những gì bạn đang tìm kiếm? Kiểm tra trung tâm trợ giúp hoặc liên hệ với chúng tôi.

Quyền truy cập REST API được tự động kích hoạt cho người dùng sử dụng gói Premium. Bạn có thể tạo khóa API trong cài đặt tài khoản dưới mục "Tích hợp".
Tất cả các yêu cầu đều cần tiêu đề Authorization với mã thông báo Bearer. Thông tin chi tiết về uỷ quyền có thể được tìm thấy trong tài liệu API.
Có, giới hạn 60 yêu cầu mỗi phút được áp dụng. Nếu bạn có nhu cầu lớn hơn, hãy liên hệ với chúng tôi.
Đi tới thiết lập tài khoản, phần "Webhooks", thêm URL điểm cuối, và chọn các sự kiện mà bạn muốn nhận thông báo. Hệ thống sẽ tự động gửi thông báo POST tới địa chỉ đã cung cấp.
Tài liệu API chứa các mô tả chi tiết của tất cả các endpoints với các ví dụ. Ngoài ra, đội ngũ hỗ trợ kỹ thuật của chúng tôi sẵn sàng hỗ trợ qua chat và email.