1. 开启上行回调接口
描述:
主动调用接口开启人脸门禁上行数据回调功能。
请求说明:
| 参数 |
类型 |
必填 |
说明 |
| 协议 |
方法 |
PATH |
|
| HTTPS |
POST |
/openApi/face/openCallback |
|
Body参数:
| 参数 |
类型 |
必填 |
说明 |
| appId |
String |
是 |
appId |
| expires |
String |
是 |
过期时间 |
| sign |
String |
是 |
签名 |
| deviceNo |
String |
是 |
设备编号 |
| cmd |
String |
是 |
固定值:faceOpenCallback |
| data |
String |
是 |
上行回调数据 |
| - onlineStatus |
int |
是 |
设备上下线回调,0:关闭,1:开启 |
| - recognizeResult |
int |
是 |
识别结果回调,0:关闭,1:开启 |
| - ioStatus |
int |
是 |
IO输入状态变化回调,0:关闭,1:开启 |
| - eventStatus |
int |
是 |
异常事件如倒车、撞杆、跟车等事件回调,0:关闭,1:开启 |
| - whiteResult |
int |
是 |
白名单下发结果回调,0:关闭,1:开启 |
| - ossJsonStr |
String |
否 |
图片储存到阿里云OSS的accessKeyId、accessKeySecret、accessEndpoint、accessImgBucket |
| - qrResult |
int |
是 |
二维码上传结果回调,0:关闭,1:开启 |
| - intercomType |
int |
否 |
设备对讲类型,0:楼栋机,1:墙外机 |
| - ticketUrl |
String |
否 |
获取票据的接口地址 |
| - intercomStatus |
int |
否 |
第三方对讲,0:关闭,1:开启 |
| - buildingNo |
String |
否 |
楼栋机不能为空 |
返回参数:
| 参数 |
类型 |
必填 |
说明 |
| code |
int |
是 |
响应状态码 |
| msg |
String |
是 |
响应消息 |
| appId |
String |
是 |
appId |
| expires |
String |
是 |
过期时间 |
| sign |
String |
是 |
签名 |
| deviceNo |
String |
是 |
设备编号 |
| cmd |
String |
是 |
固定值:faceOpenCallback |
| data |
String |
是 |
空字符串,固定值:”” |
请求示例:
{"appId":"ym3b7f242fc0814489","expires":"1739583239","deviceNo":"123456789-987654321","sign":"36f392b389e945b5c7ca8baa36fae53b","cmd":"faceOpenCallback","data":"{\"onlineStatus\":1,\"recognizeResult\":1,\"ioStatus\":1,\"eventStatus\":1,\"whiteResult\":1,\"ossJsonStr\":\"{\\\"accessKeyId\\\":\\\"adfaf8ferewc841r\\\",\\\"accessKeySecret\\\":\\\"adfaf8ferewc841rw4f1asad115\\\",\\\"accessEndpoint\\\":\\\"shenzhen\\\",\\\"accessImgBucket\\\":\\\"test\\\"}\",\"qrResult\":1,\"intercomType\":1,\"ticketUrl\":\"https://www.adad85re.com\",\"intercomStatus\":1,\"buildingNo\":\"1\"}"}
返回示例:
{
"code": 0,
"msg": "操作成功",
"appId": "ymc03e8b5544714290",
"expires": "1767841794",
"sign": "217386911ac83291070c69fc67dcb4e",
"deviceNo": "123456789-987654321",
"cmd": "faceOpenCallback",
"data": ""
}