核心用法
Hostex Skill 是一套面向度假租赁（Vacation Rental）行业的 OpenAPI v3.0 集成方案，基于 Node.js 脚本封装 Hostex 官方 API。核心功能覆盖：
- 房源管理：查询房产（properties）、房型（room types）、日历可用性（availabilities）
- 预订操作：按入住日期或预订编号检索订单，支持创建直订（Direct Booking）
- 价格策略：更新 Airbnb、Booking 等渠道的价格日历，支持单日或批量多区间调价
- 客户沟通：发送消息至对话线程
- Webhook 集成：接收实时事件推送
认证方式：通过 Hostex-Access-Token（PAT）头部鉴权，环境变量 HOSTEX_ACCESS_TOKEN 注入。推荐默认使用只读 Token，写操作需额外开启 HOSTEX_ALLOW_WRITES=true 并配合 --confirm 参数。
设计亮点：
- 日期统一使用
YYYY-MM-DD格式，按房产本地时区解释（非 UTC） - 读写分离架构：读取脚本（
hostex-read.mjs）与写入脚本（hostex-write.mjs）物理隔离 - OpenAPI 定义源：
https://hostex.io/open_api/v3/config.json，支持本地缓存同步
显著优点
1. 操作安全性高：强制确认机制 + 环境变量开关双重防护，误操作风险低
2. 多渠道兼容：原生支持 Airbnb、Booking.com 等主流 OTA 的价格与日历同步
3. 批量效率：价格更新支持多区间批量提交（如 "2026-02-03..2026-02-05:599,2026-02-06..2026-02-07:699"）
4. 日志脱敏：脚本自动红敏 Token，避免密钥泄露
潜在缺点与局限性
- 时区处理复杂：无 UTC 时间戳，跨时区房产需自行换算，易引发边界日期错误
- 写操作门槛高：需双重确认（环境变量 + 命令行参数），自动化场景下交互成本较高
- 分页限制：单次最多 100 条，大规模数据同步需自行实现分页逻辑
- 依赖外部 Token：无 OAuth 刷新机制，Token 过期需人工重配
适合人群
- 民宿/短租运营团队的技术对接人
- 需将 Hostex 数据同步至内部 BI 或客服系统的开发者
- 希望自动化价格策略、房态管理的收益管理（Revenue Management）人员
常规风险
- 误删/误改房态：尽管有确认机制，生产环境误设
HOSTEX_ALLOW_WRITES=true仍可能导致业务损失 - Token 泄露：虽然脚本脱敏，但环境变量可能被进程转储（core dump）或容器日志暴露
- API 限流/变更：Hostex 未公开速率限制细节，OpenAPI 定义更新可能与本地缓存不同步