1. 酒店领域开放API
1.1. 权限申请
资源使用方:用户可在若琪酒店后台申请应用,在应用配置时可勾选需要的权限,配置好后可将授权链接发送给资源提供方。
资源提供方:点击授权链接后,根据应用详情,用户可将名下酒店资源授权给对应的应用。
1.2. 调用方式
用户可以以应用的身份(见上文)调用酒店领域开放API,操作有权限的酒店资源。
1.2.1. 鉴权
若琪酒店API使用JWT方式鉴权。
token生成说明 使用应用信息secret,将应用中的accessKey、需要操作的酒店id,合并签名。
token = jwt.sign({accessKey: 'sdffwerdfcccx', hotel: 'q3fffetv'}, secret)
header 设置 设置 Authorization。
Authorization: ROKID_HOTEL_JWT token
1.2.2. API 调用
若琪酒店领域API使用标准graphql,可以注册若琪账号在控制台中开发测试,地址:https://hotelbase.rokid.com/graphql 配置文件确保如下配置项设置正确:
{
"request.credentials": "include"
}
具体API描述请参阅graphql控制台中文档。
注意:
在web控制台中调用任意方法,操作的都为此若琪账号下资源,请先确保当前若琪账号下有酒店、房间、设备等资源,以供调试使用。