REST API

将您的系统与REST API集成

通过我们的REST API,完全访问预订、客人和房间数据。自动化流程并将移动日历与您自己的系统集成。

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"
  }
}
功能

全面的API为您的业务

我们的 REST API 提供对所有系统功能的完整访问,使得自定义集成和自动化的创建成为可能。

CRUD 操作

全面控制数据 - 通过标准HTTP请求创建、读取、更新和删除记录。

  • 预订管理
  • 住客数据
  • 客房配置
  • 发票和付款
Webhook 实时

立即在您的服务器上接收关于系统更改的即时通知。

  • 实时通知
  • 可配置事件范围
  • 安全 HTTPS 连接
  • 自动重试
开发者日志面板

监控所有 API 请求并直接在应用程序内调试集成。

  • API 请求历史
  • 完整服务器响应
  • 错误详情
  • 30天历史
端点

访问所有数据

该API为所有关键系统资源提供端点。详细的文档和示例可在线获取。

查看文档
  • /reservations

    下载、创建和修改预订。访问完整历史和状态。

  • /guests

    管理客人数据库、联系方式和住宿历史。

  • /rooms

    配置房间、可用性、价格和设施功能。

  • /invoices

    生成发票,跟踪付款,并管理文档。

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

实时通知

Webhook允许对系统中的事件进行自动反应。配置终端 URL 并接收有关新预订、更改和取消的通知。

  • reservation.created - 新预订
  • reservation.updated - 预订修改
  • reservation.cancelled - 预订取消
  • reservation.checked_in - 客人入住
了解更多关于webhooks的信息

REST API 在高级计划中提供

访问 REST API 、webhooks 和开发者日志面板是 Premium 计划的一部分。完全掌控您酒店的集成。

REST API FAQ

常见问题

没有找到您需要的内容?请查看帮助中心或联系我们。

对于使用高级套餐的用户,REST API 的访问权限会自动激活。您可以在账户设置的“集成”部分下生成一个 API 密钥。
所有请求都需要在授权头中包含Bearer令牌。授权详细信息可以在API文档中找到。
是的,每分钟限制为60个请求。如果您有更大的需求,请联系我们。
前往账户设置,"Webhooks"部分,添加终端 URL,然后选择您要接收通知的事件。系统将自动向提供的地址发送一个 POST 通知。
API 文档包含所有端点的详细描述和示例。此外,我们的技术支持团队通过聊天和电子邮件提供服务。