面板机
  1. 平台核验通行
面板机
  • 平台核验通行
    • 接口说明文档
    • 通行验证
      POST
    • 通行上报
      POST
  1. 平台核验通行

接口说明文档

系统概览
1.jpg
访客在售票处买票后(登记身份证或者拿到二维码票证等方式),在闸机前出示,FaceTick设备会将该凭证发送到票务平台验证,平台返回凭证有效则开闸,合成并语音播报平台返回的语音播报文本(若有需求,合成文本尽量简短,以免影响体验),设备界面展示平台返回的凭证信息;
如果闸机支持检测访客是否通行并开启,那么访客通过闸机后会上报“人员通过”到票务平台,票务平台根据是否关心访客通行进行处理。
前置条件
平台需要自己定义生成Appid和SecretKey(长度限制不超过32字节)
鉴权参数
请求头里需要4个参数
AppId:对接api的应用id;
Timestamp:时间戳(毫秒);
ReqId:请求id,每个请求唯一的id;
Sign:请求签名;
Sign签名规则
AppId拼接上时间戳,请求id,秘钥,中间用#间隔开, 然后计算MD5值, 转小写:
Sign=MD5(AppId+"#"+Timestamp+"#"+ReqId+"#"+SecretKey).toLower()
服务端校验时验证签名是否一致,再校验请求id和时间戳是否合法.
Body请求参数
业务请求数据放在body中, json格式, 详细消息结构根据业务定义
响应内容
{
"code": 0,
"data": {}
}
code为错误码, 0表示成功, -1表示鉴权失败, 其他根据具体业务定义;
data为业务响应具体内容;
联调测试
设备已经连接到facepass平台,并且开启了开门二次确认推送
image.png
设备上已配置第三方平台服务器地址,以及鉴权使用的AppId和SecretKey
image.png
平台返回凭证有效,设备界面展示
1733387782232.png
平台返回凭证无效,设备界面展示
image.png
下一页
通行验证
Built with