现在你可以直接基于 Veridien 做开发了。驱动我们自家预订流程的那套引擎向你开放:自建预订引擎、面向客人的移动应用、会员体系对接,或者任何后台自动化。
它就是一套普通的 HTTP/JSON 接口。用按酒店签发的 API 密钥认证,收发 snake_case 的 JSON,依赖标准状态码和统一的错误返回结构。每个密钥都带权限范围,只能做你授予的事,而且只作用于它所属的那一家酒店。
- 按酒店签发的 API 密钥。 在设置 → API 密钥中创建、限定范围并吊销密钥。密钥只显示一次,且仅以哈希形式保存。
- 受限的访问权限。 十二种细分权限范围(例如
availability:read、reservations:write、folio:write)为每个接口把关,其中还有独立的guests:read:pii用于客人的敏感个人信息。 - 完整的预订生命周期。 查询房量、按可见性规则为一次住宿定价、注册或关联客人、锁定房量、确认已付款的预订,并向账单记账。
- 会员体系。 读取客人的积分余额与等级、兑换积分,并在住宿确认后自动累积。
- 安全的重试。 写操作请求支持
Idempotency-Key,网络重试绝不会造成重复预订或重复扣款。预订确认还会按付款流水号做幂等处理。 - 可预期的错误。 每次失败都返回带稳定
code、可选param与request_id的结构化错误。 - OpenAPI 3.1 描述文件。 每个接口的机器可读描述发布在
/api/v1/openapi.json,可用来生成带类型的客户端。
| 领域 | 你可以做什么 |
|---|---|
| 目录 | 读取酒店信息、房型、房量与可用的房价方案 |
| 客人 | 注册或关联客人、读取与更新档案、读取会员信息 |
| 预订 | 锁定房量、确认预订、列出与读取预订、取消 |
| 账单 | 读取某条预订的账单并向其记账 |
| 会员 | 读取积分余额与等级、兑换积分 |
完整参考、快速上手与可直接复制的示例都在 API 文档里。基础地址是 https://veridien.app/api/v1。