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": ""
}
作者：yrh  创建时间：2026-06-06 16:05
最后编辑：yrh  更新时间：2026-06-06 17:19