人脸识别终端数据上报接口说明书
人脸机在刷卡或者人证对比通过后，向指定上位机上报信息，并根据上位机指示操作。
上报URL可以配置，格式如http://192.168.0.99/upload.asp
数据使用POST上传，内容为JSON字符串
JSON数据编码:UTF-8
返回JSON格式数据
ü 刷卡上报数据JSON格式如下
{
"code":0,
"message":”操作成功”,
“devid”:”12345”,
“devname”:”人脸机1”,
“readinfo”:{
“cardid”:”1234567890”,
“image”:”data/201902200303.jpg”,
“name”:”张三”,
“sex”:”男”,
“kind”:”汉”,
“birthday”:”1975-06-20”,
“address”:”广东省广州市”,
“effect”:”2005-01-01”,
“expire”:”2020-01-01”,
“cert”:”广州市天河公安局”
},
}
Code为0表示操作成功，其它表示错误，message为错误信息。Devid和devname为设备ID和名称。Readinfo是读卡信息，其中cardid必填。
ü 返回数据JSON格式如下
{
"code":0,
"message":”操作成功”,
“cmdinfo”:{
“image”:”data/201902200303.jpg”,
“open”:”1”,
“delay”:”300”,
“tts”:”您好，欢迎光临”,
“prompt”:”验证通过”,
“state”:”3”
}
}
Code为0表示操作成功，其它为错误。cmdinfo为指令信息，可选image表示需要上传的图片，名称由上报接口中取得，空表示不需要上传。open表示远程开门，空表示不需要开门。delay是开门时长毫秒数，仅在open值不为空时有效。tts是语音提示空表示无提示，prompt是文本提示空表示无提示，state是验证结果图标（1验证成功，2已开门请通过，3验证失败）空表示不改变验证结果图标
注意：结果提示prompt的内容小于16字节时会自动tts朗读（超过16字节就不会），如果需要禁止朗读在内容前加#，如果长度大于16字节的prompt内容要强制朗读则在内容前加$，或者使用单独的tts控制朗读。
ü 图片上报数据JSON格式如下
{
"code":0,
"message":”操作成功”,
“devid”:”12345”,
“devname”:”人脸机1”,
“readinfo”:{
“image”:”data/201902200303.jpg”,
“image-base64”,”xxxx”,
},
}
Readinfo中的image是指令中要求上传的文件名，image-base64是图片BASE64编码的数据
ü 图片上报数据返回JSON格式如下
{
"code":0,
"message":”操作成功”
}