fb-hotel-skill

name fb-hotel-skill description 分贝通酒店预定助手，实时查询搜索酒店、展示酒店列表、查询酒店房型、展示房型产品和报价、预定酒店、查看订单、取消订单、查看酒店基础信息和酒店评论信息。 version 3.2.0 metadata {"openclaw":{"emoji":"🏨","category":"travel","tags":["分贝通","酒店","房型","预订","退订","报价"],"requires":{"bins":"[Truncated]"},"required":true}} 分贝通酒店预定助手 (fb-hotel-skill) 技能描述 分贝通酒店预定助手，实时查询搜索酒店、展示酒店列表、查询酒店房型、展示房型产品和报价、预定酒店、查看订单、取消订单、查看酒店基础信息和酒店评论信息。 🔐 鉴权流程（必须先完成） 重要 ：使用任何功能前，用户必须先完成鉴权流程。鉴权成功后获得的 identity_code （access-token）会自动保存在 ~/.fbt-auth.json 文件中，新会话会自动沿用。 鉴权步骤 步骤 1：发送验证码 用户回复: 分贝通登录 AI: 请输入您的手机号以接收验证码（例如：13800138000） 用户输入: 13800138000 AI: ✅ 验证码已发送到 138****8000，请在5分钟内输入验证码 API调用 ： from scripts.fb_hotel_api import send_verification_code result = send_verification_code( "13800138000" ) # 成功响应: {"code": 0, "msg": "success", "data": true} 步骤 2：验证并获取 identity_code 用户输入: 1234 AI: 🎉 认证成功！身份编码已保存到 ~/.fbt-auth.json，有效期90天 现在可以使用分贝通企业接口了 API调用 ： from scripts.fb_hotel_api import verify_and_get_token success, result = verify_and_get_token( "13800138000" , "1234" ) if success: access_token = result # fbsk-xxx # token 已自动保存到 ~/.fbt-auth.json else : print ( f"验证失败: {result} " ) 步骤 3：自动注入（后续调用） 后续所有 API 调用会自动从 ~/.fbt-auth.json 读取 token： from scripts.fb_hotel_api import FbHotelApi # 无需传入 token，自动从文件读取 api = FbHotelApi() result = api.search_hotel_list(city_name= "北京市" , keywords= "国贸" ) Token 存储管理 文件 路径 说明 鉴权文件 ~/.fbt-auth.json 保存 identity_code 和手机号 文件格式 ： { "identity_code" : "fbsk-2db251f6c8d74ce69ae3dcb82ed1055b" , "mobile" : "138****8000" , "created_at" : "2026-03-25T09:48:00" , "updated_at" : "2026-03-25T09:48:00" } API 函数 from scripts.fb_hotel_api import ( save_auth_token, # 保存 token load_auth_token, # 读取 token get_auth_info, # 获取完整认证信息 clear_auth_token # 清除认证信息 ) # 保存 token save_auth_token( "fbsk-xxx" , "13800138000" ) # 读取 token token = load_auth_token() # 获取完整信息 info = get_auth_info() # {"identity_code": "...", "mobile": "..."} # 清除认证 clear_auth_token() 接口鉴权说明 skill_type 接口名称 需要认证 getMobileCaptcha 获取手机号验证码 ❌ 否 getIdentityCode 获取身份编码 ❌ 否 searchHotelList 搜索酒店列表 ✅ 是 queryHotelPrice 查询酒店价格详情 ✅ 是 queryHotelDetail 查询酒店扩展详情 ✅ 是 queryHotelComment 查询酒店评论 ✅ 是 createOrder 酒店下单 ✅ 是 cancelOrder 取消订单 ✅ 是 queryOrder 查询订单 ✅ 是 ⚠️ 【重要约束】 必须调用 scripts/fb_hotel_api.py 中的函数获取数据 禁止自行编造酒店信息、价格或评论 接口返回什么数据就展示什么，不要修改 首次使用必须先完成分贝通企业认证 对接信息 环境配置 环境 域名 FAT 测试环境 https://app-gate.fenbeitong.com 线上环境 https://app-gate.fenbeitong.com 统一接口入口 所有接口统一使用同一入口 ： POST /business/hotel/open/push/skill/access 通过 skill_type 参数区分不同操作。 请求格式 Headers : Content-Type: application/json access-token: fbsk-xxx （认证类接口除外） Body : { "skill_type" : "searchHotelList" , // 其他参数... } 核心接口列表 一、认证类接口 1. 获取手机号验证码 skill_type : getMobileCaptcha 请求示例 ： curl --location 'https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access' \ --header 'Content-Type: application/json' \ --data '{ "skill_type":"getMobileCaptcha", "mobile":"18301187051" }' 响应示例 ： { "request_id" : "nQabT9pHt5u5m0mA" , "code" : 0 , "msg" : "success" , "data" : true } 2. 获取身份编码 skill_type : getIdentityCode 请求示例 ： curl --location 'https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access' \ --header 'Content-Type: application/json' \ --data '{ "skill_type":"getIdentityCode", "mobile":"18301187051", "captcha":"1234" }' 响应示例 ： { "request_id" : "oKXv9eCYuFIXoxRn" , "code" : 0 , "msg" : "success" , "data" : { "identity_code" : "fbsk-2db251f6c8d74ce69ae3dcb82ed1055b" } } 二、酒店查询接口 1. 搜索酒店列表 skill_type : searchHotelList 请求参数 ： 参数 类型 必填 说明 city_name string 是 城市名称（如"北京市"） keywords string 否 关键词（用户输入原样传递） hotel_name string 否 酒店名称 page_index int 否 页码，默认1 page_size int 否 每页数量，默认5 请求示例 ： curl --location 'https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access' \ --header 'access-token: fbsk-2db251f6c8d74ce69ae3dcb82ed1055b' \ --header 'Content-Type: application/json' \ --data '{ "skill_type":"searchHotelList", "city_name":"北京市", "keywords":"预订北京国贸附近1公里的酒店", "page_index":1, "page_size":5 }' 响应字段 ： 字段 说明 hotel_id 酒店ID name 酒店名称 star_level_name 星级类型（高档型、豪华型等） address 地址 district_name 区域 business_zone_name 商圈 score 评分 min_price 最低价 main_logo 酒店图片 2. 查询酒店价格详情 skill_type : queryHotelPrice 请求参数 ： 参数 类型 必填 说明 hotel_id string 是 酒店ID check_in_date string 是 入住日期 yyyy-MM-dd check_out_date string 是 退房日期 yyyy-MM-dd payment_type string 否 支付方式 PP=预付 SP=现付 nation_type int 否 1=国内 2=国际 请求示例 ： curl --location 'https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access' \ --header 'access-token: fbsk-2db251f6c8d74ce69ae3dcb82ed1055b' \ --header 'Content-Type: application/json' \ --data '{ "skill_type":"queryHotelPrice", "nation_type":1, "payment_type":"PP", "hotel_id":"5a39df2fbbfdc4732360eaa9", "check_in_date":"2026-03-27", "check_out_date":"2026-03-28" }' 响应字段 ： 字段 说明 hotel 酒店基本信息 rooms[] 房型列表 rooms[].room_id 房型ID rooms[].room_name 房型名称 rooms[].bed_type 床型 rooms[].window_type 窗户类型 rooms[].area 面积 rooms[].status 是否可预订 rooms[].plan_list[] 产品列表 plan_list[].plan_id 产品ID plan_list[].plan_name 产品名称 plan_list[].breakfast 早餐 plan_list[].cancel_type 取消政策类型 plan_list[].cancel_rule 取消政策详情 plan_list[].total_price 总价 plan_list[].status 是否可预订 3. 查询酒店扩展详情 skill_type : queryHotelDetail 请求参数 ： 参数 类型 必填 说明 hotel_id string 是 酒店ID 4. 查询酒店评论 skill_type : queryHotelComment 请求参数 ： 参数 类型 必填 说明 hotel_id string 是 酒店ID page_index int 否 页码 page_size int 否 每页数量 请求示例 ： curl --location 'https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access' \ --header 'access-token: fbsk-2db251f6c8d74ce69ae3dcb82ed1055b' \ --header 'Content-Type: application/json' \ --data '{ "skill_type":"queryHotelComment", "hotel_id":"8502475", "page_size":5 }' 三、订单接口 1. 酒店下单 skill_type : createOrder 请求参数 ： 参数 类型 必填 说明 nation_type int 是 1=国内 2=国际 payment_type string 是 PP=预付 SP=现付 hotel_id string 是 酒店ID check_in_date string 是 入住日期 check_out_date string 是 退房日期 room_id string 是 房型ID plan_id string 是 产品ID