Hostex API 技能 (Node)

认证 (PAT)

• - 设置环境变量：HOSTEXACCESSTOKEN
• 请求使用请求头：Hostex-Access-Token:
• OpenAPI 安全方案名称：HostexAccessToken

默认建议： 使用只读 PAT。

日期/时区

• - 所有日期参数格式为 YYYY-MM-DD
• 按房源时区解释日期（无 UTC 时间戳）

OpenAPI 权威来源

稳定的 OpenAPI JSON：

• - https://hostex.io/open_api/v3/config.json

使用 scripts/openapi-sync.mjs 将本地副本缓存到 references/openapi.json。

快速命令（脚本）

所有脚本均需 HOSTEXACCESSTOKEN。

只读（安全）

列出房源：
bash
node skills/hostex/scripts/hostex-read.mjs list-properties --limit 20

列出预订（按入住日期范围）：
bash
node skills/hostex/scripts/hostex-read.mjs list-reservations --start-check-in-date 2026-02-01 --end-check-in-date 2026-02-28 --limit 20

列出预订（按预订代码）：
bash
node skills/hostex/scripts/hostex-read.mjs list-reservations --reservation-code 0-1234567-abcdef

获取可用性：
bash
node skills/hostex/scripts/hostex-read.mjs get-availabilities --start 2026-02-10 --end 2026-02-20 --property-id 123

写入（受保护）

写入操作默认禁用，除非：

• - HOSTEXALLOWWRITES=true

并且传递 --confirm 参数。

发送消息：
bash
HOSTEXALLOWWRITES=true node skills/hostex/scripts/hostex-write.mjs send-message --conversation-id 123 --text 你好！ --confirm

更新房源价格（单日期范围示例）：
bash
HOSTEXALLOWWRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \
--channel-type airbnb \
--listing-id 456 \
--start 2026-02-10 \
--end 2026-02-15 \
--price 199 \
--confirm

更新房源价格（单次请求多日期范围）：
bash
HOSTEXALLOWWRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \
--channel-type booking_site \
--listing-id 100541-10072 \
--prices 2026-02-03..2026-02-05:599,2026-02-06..2026-02-07:699,2026-02-08..2026-02-09:599 \
--confirm

创建预订（直接预订）（示例）：
bash
HOSTEXALLOWWRITES=true node skills/hostex/scripts/hostex-write.mjs create-reservation \
--property-id 123 \
--custom-channel-id 77 \
--check-in-date 2026-02-10 \
--check-out-date 2026-02-12 \
--guest-name 爱丽丝 \
--currency USD \
--rate-amount 200 \
--commission-amount 0 \
--received-amount 200 \
--income-method-id 3 \
--confirm

更新房源可用性（关闭/开放）（示例）：
bash

关闭某房源在日期范围内的可用性

操作安全护栏（强制要求）

执行任何写入操作时：
1) 总结变更内容（谁/什么/何时/多少）。
2) 要求用户明确确认（例如 CONFIRM）。
3) 如果可用，优先使用 --dry-run。

备注

• - 分页：端点通常接受 offset + limit（最大限制为 100）。
• 切勿在日志中打印令牌；脚本会自动隐藏密钥。