用途:本技能用于对接 Hospitable.com 公共 API v2,适合需要读取或操作房源、预订、日历、询价、消息、会话、交易、结算、评价及动态短代码等数据的场景。编码前须先阅读 types.ts(类型与枚举)与 client.ts(封装好的类型化 HTTP 客户端),不要自行重定义类型或编写 fetch 包装。
主要能力:覆盖用户、房源、日历、询价、预订、消息、会话、交易、结算、评价与可丰富短代码等资源,支持 ?include= 一次性嵌入关联实体以避免 N+1 请求。列表接口返回分页结构,客户端内置 listAll() 自动翻页。
使用方式:基础地址为 https://public.api.hospitable.com/v2,鉴权支持 OAuth 2.0 或个人访问令牌(PAT),需在请求头携带 Authorization: Bearer <ACCESS_TOKEN>、Accept: application/json、Content-Type: application/json,令牌从环境变量 HOSPITABLE_ACCESS_TOKEN 读取。所有日期为 UTC/ISO 8601,实体 ID 为 UUID。所有 POST、PATCH、PUT 必须传入 crypto.randomUUID() 作为幂等键。分页数据需读取 .data 字段并可用 listAll() 自动分页。限流通过 X-RateLimit-Remaining 与 X-RateLimit-Reset 响应头检查,遇 429 客户端会抛错。Webhook 主题含 reservation.created、reservation.changed、reservation.status_changed、message.create、message.updated、inquiry.created、review.created、property.created、property.deleted、property.merged、integration.disconnected;需校验 Signature 头并放行入站 IP 38.80.170.0/24。
限制:具体收费、价格与额度未提供。官方文档见 https://developer.hospitable.com/docs/public-api-docs/d862b3ee512e6-introduction。