沃土开放平台

API文档 > 回调管理类 > 识别回调

当有人员被设备识别出后,云端服务器会向回调URL地址POST字段deviceKey、personGuid、showTime、photoUrl、type和data。回调有补发机制,若即时回传消息给回调URL未成功,会重试五次发送,间隔为65秒,70秒,5分钟,30分钟,1小时,3小时,6小时,12小时,24小时。

ContentType:application/x-www-form-urlencoded

{
	"personGuid": "STRANGERBABY",//人员guid,陌生人为STRANGERBABY,人证比对为IDCARDBABY
	"deviceKey": "84E0F420013300B4",//设备序列号
	"photoUrl": "http://uniubi-device-test.oss-cn-hangzhou.aliyuncs.com/device/spot/photo/84E0F420013300B4/2017-11-16/STRANGERBABY_20171116153434.jpg",//现场照url
	"showTime": "1510817674000",//识别记录时间
	"data": "{\"name\":\"宇泛测试\",\"idNo\":\"88888\",\"height\":\"211\",\"width\":\"211\",\"xAxis\":\"474\",\"yAxis\":\"243\"}",//人脸附属信息。若data数据json解析不正确,可使用data.replace("\\\"","\"")再进行解析
	"type": 2,//识别出的人员类型,0:时间段内,1:时间段外,2:陌生人
	"recMode": 1,//识别模式,1:刷脸,2:刷卡,3:双重认证, 4:人证比对
	"idCardInfo":{
                  "name":"宇泛",//姓名
                  "sex":"男",//性别
                  "nation":"汉",//民族
                  "birthday":"2018-01-01",//出生年月日
                  "name":"宇泛",//姓名
                  "idNum":"330326201801010818",//公民身份号码
                  "address":"浙江省杭州市西湖区文一路",//住址
                  "issuingOrgan":"西湖区公安局",//签发机关
                  "photoPath":"http://uniubi-device-test.oss-cn-hangzhou.aliyuncs.com/device/spot/photo/84E0F4200D4202FA/2018-04-12/STRANGERBABY_20180412193059_idCardImg.jpg",//身份证照
                  "usefulLife":"2008.09.16-2018.09.16",//有效期限
                  "compareResult":false,//比对结果
                  "id":0,//卡编号,部分身份证阅读器不支持读取
                  "createTime":1514822399999,//比对时间
                  "deviceKey":"84E0F4200D4202FA"//比对设备序列号
    }//人证比对详细
}
字段 描述 类型 说明
deviceKey 设备序列号 String
personGuid 人员id String 人员录入接口调用成功后,由云端服务器生成并返回;陌生人为STRANGERBABY
showTime 识别时间 String yyyy-MM-dd HH:mm:ss
photoUrl 现场照url String 回调photoUrl要求设备为v2.7及以上版本
type 识别出的人员分类 String 0:时间段内,1:时间段外,2:陌生人
data 其他数据 String name:人员姓名
idNo:IC卡/身份证卡号
height:人脸框高度(单位:px)
width:人脸框宽度(单位:px)
xAxis:人脸框左上角顶点坐标(单位:px)
yAxis:人脸框左上角顶点坐标(单位:px)
recMode 识别模式 String 1:刷脸,2:刷卡,3:双重认证, 4:人证比对
idCardInfo 人证比对详细 String name : 姓名
sex : 性别
nation : 民族
birthday : 出生年月日
idNum : 公民身份号码
address : 住址
issuingOrgan : 签发机关
photoPath : 身份证照
usefulLife : 有效期限
compareResult : 比对结果
id : 卡编号(部分身份证阅读器无法读取)
createTime : 比对时间
deviceKey : 比对设备序列号