SuperAPI AI 工具集

b2b-booking

办公与效率

查看项目

更新于 10-23 16:18

技能介绍

B2B Booking 是一个酒店预订技能(Skill),通过 HTTP API 提供从搜索到下单的完整酒店预订能力。所有接口均为 POST 请求,需在请求体中携带 user_key 字段,响应成功格式为 {"ok": true, "data": {...}},失败格式为 {"ok": false, "error": "..."}。

主要能力 该技能提供七类接口:/skill/search_location 用于按关键词(城市、地标、酒店名等)搜索地区与酒店,返回带 region_id 的地区列表和带 hotel_id 的酒店列表;/skill/search_hotels 按地区、入住与离店日期、成人数及可选价格区间搜索酒店,最多返回 3 家最便宜的酒店;/skill/query_room_rates 查询指定酒店的房型与房价,返回 rate_code、total_price、currency_code、meal_info、refundable、cancelPolicyInfos 等字段;/skill/check_room_availability 校验实时价格并锁定房间,返回的 rate_code 与价格可能与上一步不同,应以此次结果为准;/skill/create_booking 创建订单,返回 agent_ref_id 作为预订编号,无需手机号或邮箱;/skill/query_booking 随时查询订单;/skill/cancel_booking 取消订单,返回状态、取消费与退款金额;/skill/pay_order 发起支付,payment_type 为 11 表示微信支付、12 表示支付宝,返回 pay_url 供用户完成付款。

使用方式 使用前需完成身份认证:读取 {baseDir}/user_key.txt,若文件不存在或为空,则不得调用任何接口,需提示用户访问指定的 AgentAuth Dashboard 登录 Google 获取 user_key(格式 uk_xxxxxxxx),获取后保存到该文件再继续;若文件已有内容则直接使用。当接口返回 HTTP 401 或包含 unauthorized 的错误时,应立即停止流程,删除 user_key.txt 并要求用户重新获取。标准预订流程为:搜索地区获取 region_id → 搜索酒店 → 查询房型价格 → 校验价格并锁房 → 创建订单 → 询问用户支付方式后发起支付 → 可随时查询订单 → 仅在用户明确要求并确认预订编号后取消订单。

限制与注意事项 所有酒店、房型与价格数据必须来自实时 API 响应,禁止凭训练数据或记忆编造;接口失败且重试无效时应向用户报告具体错误,不得自行推荐替代方案。日期须为 YYYY-MM-DD 格式,region_id 与 hotel_id 必须以字符串传递,total_price 必须使用 check_room_availability 返回的值。取消政策中 refundable: true 表示可退款、可取消,startDateTime 为免费取消截止时间,amount 为截止后收取的取消费用,amount 大于 0 并不代表不可取消。展示多个酒店的房型时,各酒店数据必须严格来自其自身的查询结果,不得混用;某酒店无房时应仅提示无房。取消订单前始终与用户确认预订编号。更详细的参数参考、地区 ID、货币代码与故障排查可见 references/parameter_guide.md。