分贝通酒店预定助手 (fb-hotel-skill)

技能描述

分贝通酒店预定助手，实时查询搜索酒店、展示酒店列表、查询酒店房型、展示房型产品和报价、预定酒店、查看订单、取消订单、查看酒店基础信息和酒店评论信息。

🔐 鉴权流程（必须先完成）

重要：使用任何功能前，用户必须先完成鉴权流程。鉴权成功后获得的 identity_code（access-token）会自动保存在 ~/.fbt-auth.json 文件中，新会话会自动沿用。

鉴权步骤

步骤 1：发送验证码

用户回复: 分贝通登录
AI: 请输入您的手机号以接收验证码（例如：13800138000）

用户输入: 13800138000
AI: ✅ 验证码已发送到 1388000，请在5分钟内输入验证码

API调用：
python
from scripts.fbhotelapi import sendverificationcode

result = sendverificationcode(13800138000)

成功响应: {code: 0, msg: success, data: true}

步骤 2：验证并获取 identity_code

用户输入: 1234
AI: 🎉 认证成功！身份编码已保存到 ~/.fbt-auth.json，有效期90天
现在可以使用分贝通企业接口了

API调用：
python
from scripts.fbhotelapi import verifyandget_token

success, result = verifyandget_token(13800138000, 1234)
if success:
access_token = result # fbsk-xxx
# token 已自动保存到 ~/.fbt-auth.json
else:
print(f验证失败: {result})

步骤 3：自动注入（后续调用）

后续所有 API 调用会自动从 ~/.fbt-auth.json 读取 token：

python
from scripts.fbhotelapi import FbHotelApi

无需传入 token，自动从文件读取

Token 存储管理

文件格式：
json
{
identity_code: fbsk-2db251f6c8d74ce69ae3dcb82ed1055b,
mobile: 1388000,
created_at: 2026-03-25T09:48:00,
updated_at: 2026-03-25T09:48:00
}

API 函数

python
from scripts.fbhotelapi import (
saveauthtoken, # 保存 token
loadauthtoken, # 读取 token
getauthinfo, # 获取完整认证信息
clearauthtoken # 清除认证信息
)

保存 token

读取 token

获取完整信息

清除认证

接口鉴权说明

• - 必须调用 scripts/fbhotelapi.py 中的函数获取数据
• 禁止自行编造酒店信息、价格或评论
• 接口返回什么数据就展示什么，不要修改
• 首次使用必须先完成分贝通企业认证

对接信息

环境配置

统一接口入口

所有接口统一使用同一入口：

POST /business/hotel/open/push/skill/access

通过 skill_type 参数区分不同操作。

请求格式

Headers:

Content-Type: application/json
access-token: fbsk-xxx （认证类接口除外）

Body:
json
{
skill_type: searchHotelList,
// 其他参数...
}

核心接口列表

一、认证类接口

1. 获取手机号验证码

skill_type: getMobileCaptcha

请求示例：
bash
curl --location https://app-gate.fenbeitong.com/business/hotel/open/push/skill/access \
--header Content-Type: application/json \
--data {
skill_type:getMobileCaptcha,
mobile:18301187051
}

响应示例：
json
{
request_id: nQabT9pHt5u5m0mA,
code: 0,
msg: success,
data: true
}

2. 获取身份编码

skill_type: getIdentityCode

请求示例：
bash
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
}

响应示例：
json
{
request_id: oKXv9eCYuFIXoxRn,
code: 0,
msg: success,
data: {
identity_code: fbsk-2db251f6c8d74ce69ae3dcb82ed1055b
}
}

二、酒店查询接口

1. 搜索酒店列表

skill_type: searchHotelList

请求参数：

请求示例：
bash
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
}

响应字段：

2. 查询酒店价格详情

skill_type: queryHotelPrice

请求参数：

请求示例：
bash
curl --location