人脸识别终端数据上报接口说明书

 

 

 

目录

目录

1. 功能

2. 上报接口约定

3. 上报格式

 

 

 

 

 

 

1. 
功能

人脸机在刷卡或者人证对比通过后,向指定上位机上报信息,并根据上位机指示操作。

2. 上报接口约定

上报URL可以配置,格式如http://192.168.0.99/upload.asp

数据使用POST上传,内容为JSON字符串

JSON数据编码:UTF-8

返回JSON格式数据

3. 上报格式

ü 刷卡上报数据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:广州市天河公安局

},

}

Code0表示操作成功,其它表示错误,message为错误信息。Deviddevname为设备ID和名称。Readinfo是读卡信息,其中cardid必填。

 

ü 返回数据JSON格式如下

{

 "code":0,

 "message":操作成功,

 cmdinfo:{

image:data/201902200303.jpg,

open:1,

delay:300,

tts:您好,欢迎光临,

prompt:验证通过,

state:3

}

}

Code0表示操作成功,其它为错误。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":操作成功

}