ChatBeds 开发者平台
开发能读写 ChatBeds 中酒店房间、价格、预订和账单的集成。ChatBeds 是通过 WhatsApp 和网页后台运营的酒店 PMS。
ChatBeds 通过 WhatsApp 和网页后台管理酒店的前台、预订、客房和账务。借助开发者平台,你的软件可以通过一个 REST API——Partner API(/partner/v1)——处理这些数据,并通过带签名的 webhook 获知变化。
你可以开发什么
- 预订网站和渠道。 查询实时房态和价格,然后创建、修改和取消预订。
- 渠道管理和 PMS 连接器。 读取房型、价格计划和房间,并让你保存的每笔预订保持同步,无论是谁创建的。
- 客人消息工具。 按日期、客人姓名或你自己的编号查找住宿,在预订变化时及时响应。
- 付款和会计工具。 读取客人账单、添加费用、记录付款,并在酒店自己的 Stripe 账户上创建银行卡付款链接。
两种接入方式
| 应用(推荐) | 私有密钥 | |
|---|---|---|
| 适用对象 | 你提供给许多酒店的软件 | 直接与你合作的一家酒店 |
| 酒店如何连接 | 在应用目录中点击 Connect,再点击 Allow(OAuth 2.0) | 业主在 Settings → Partner API 创建密钥并发给你 |
| 凭证 | 访问令牌 cbat_...(1 小时)和刷新令牌 | API 密钥 cbk_...(撤销前不会过期) |
| 权限 | 仅限酒店允许的权限范围(scopes) | 该物业的全部内容 |
两种方式在同一个基础地址调用同样的 25 个操作,幂等性、速率限制和 webhook 都相同。每个凭证只代表一个物业。
整体流程
- 你注册免费开发者账户,获得带测试数据的 Sandbox Hotel 和一个 API 密钥。
- 你用这个密钥在沙盒上开发。
- 你在 Developers 页面注册一个应用,获得 client ID 和 secret。
- 你用 OAuth 把应用连接到自己的沙盒,测试完整流程。
- 你提交应用审核。ChatBeds 批准后,它会上架到每家酒店的应用目录。
- 酒店连接你的应用后,你的服务器用授权码换取令牌,并为该物业调用
/partner/v1。 - 每当该物业的预订被创建、修改或取消时,ChatBeds 都会向你的 webhook 地址发送一个带签名的事件。
免费开发
开发者账户和 Sandbox Hotel 免费,永不收费。在审核前的任何阶段,你都可以把自己的应用连接到自己的沙盒。
下一步
正在开发什么?