Agent Skills
返回列表
华住酒店查询助手

华住酒店查询助手

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据官方安装指南 https://skillhub.cn/install/skillhub.md，将 @user_e2f0f927/huazhuhelper 安装到你的 AI 助手中。

技能介绍

为什么要封装华住酒店列表查询

对接华住 OpenAPI 获取酒店列表时，开发者首先要面对的是一套典型的 OAuth2 认证流程：先用 clientId 和 clientSecret 换取 access token，再在每次业务请求中携带 Authorization: Bearer 头，还要自行维护 token 的过期刷新逻辑。此外，请求头中需要拼装 distributorId、毫秒级 timestamp 和 traceId，任何一个字段遗漏都会导致请求失败。真正写代码时，这些样板逻辑往往比业务本身更耗时。

技能如何工作

huazhuhelper 把上述流程固化为一个可复用的技能，核心能力包括：

  • OAuth2 认证自动化：使用 Basic base64(clientId:secret) 方式向 token 接口发起请求，自动完成凭证编码和会话建立
  • Token 管理：获取 token 后自动注入后续查询请求，过期时重新执行获取流程
  • 酒店列表查询：向华住 OpenAPI 发起酒店列表请求，自动填充渠道 Code、时间戳和追踪 ID

使用时，技能会先向你索要三项必要参数：clientId、clientSecret 和 distributorId（渠道 Code，默认 MEITUAN）。随后按以下步骤执行：

  1. 安装项目依赖
  2. 确认目标环境——测试环境默认为 https://test-oauth2-api.huazhu.com，生产环境为 https://openapi.huazhu.com
  3. 在项目根目录运行查询脚本，脚本位于技能安装目录下的 scripts/ 路径中（通常为 ~/.openclaw/skills/huazhuhelper）

注意点与适用边界

这套技能只覆盖酒店列表查询这一个场景，不涉及订单、房价等其他华住 API。使用前请确认：

  • 凭证有效性：clientId 和 clientSecret 必须由华住正式分配，401 错误通常意味着凭证有误
  • IP 白名单：返回 403 时，说明当前出口 IP 不在华住授权列表中，需联系华住侧添加后再重试
  • 环境选择：测试环境请求头需附加 X-Lane-Tag: preview，切换到生产环境前应移除该标记
  • 渠道 Code：distributorId 需与华住侧登记的渠道一致，填错会导致查不到数据

另外，token 过期后技能会自动重新获取，无需手动干预；但如果凭证本身已失效，则需要更新 clientId 和 clientSecret 后重跑整个流程。

使用场景

  • 技术团队正在对接华住酒店数据源，需要通过脚本快速拉取酒店列表，不想手写OAuth2认证流程。
  • 后端工程师要验证华住OpenAPI的Token获取逻辑，想用脚本测试clientId和clientSecret是否有效。
  • 运维人员需要在测试环境确认不同渠道Code的酒店列表返回结果，希望快速切换环境执行查询。
  • 项目经理想确认华住API的401和403错误具体由什么原因导致，需要通过技能获取清晰的错误诊断。

适合人员

  • 正在对接华住OpenAPI的后端开发工程师，需要快速获取酒店列表并处理认证，减少重复造轮子的时间。
  • 负责酒店数据集成的技术负责人，希望将华住酒店列表查询能力封装成可复用的技能，降低团队接入成本。
  • 需要排查华住API认证问题的运维工程师，想通过技能快速定位401或403错误的具体原因。
  • 在测试环境验证渠道配置的QA工程师，需要确认不同distributorId下的酒店数据返回是否符合预期。