上传人脸抓拍照片
接口地址: SERVICE-ADDRESS/attendance/uploadRecentPhoto
新接口地址:
SERVICE-ADDRESS/attendance/uploadRecentPhotoByDeviceCode?deviceCode={deviceCode}
(使用此接口时,以deviceCode定位设备所属项目以及租户,requestBody中无需再传tenantId与projectId,其它参数两接口一致,如下所示)
uploadRecentPhoto接口中fileName字段格式:
文件名{workerId-时间戳}.jpg
: "5012832-1585879657703.jpg"
scan接口中人脸照片scanPhoto格式:
worker/%d/face/+文件名{workerId-时间戳}.jpg
: "worker/%d/face/5012832-1585879657703.jpg"
%d
为固定值,默认图片上传和扫描数据上传为异步模式,异步模式时按此填写,服务器端会动态替换,这是为了兼容部分设备先传考勤数据,后传递图片,%d
为占位符后续后动态检查服务端是否存在此照片, 当然服务方也可以先调用接口然后等待返回successKey,此为同步模式此时可以直接把反馈的successKey传递到 scanData下的scanPhoto字段
异步模式的结构
"scan_data" : {
"scanPhoto" : "worker/%d/face/5000369-1585292468411.jpg",
"temperature" : "36.5"
}
同步模式的结构
"scan_data" : {
"scanPhoto" : "worker/236606363873280/face/5000369-1585292468411.jpg",
"temperature" : "36.5"
}
方法:post 内容类型:application/json
header头部参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
appid | String | 是 | 唯一凭证 |
sign | String | 是 | 签名 |
ts | Long | 是 | 系统当前毫秒数 |
body参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
module | string | 是 | 固定值:worker |
base64 | string | 是 | 文件base64编码 |
fileName | string | 是 | 文件名 |
projectId | long | 是 | 项目ID |
fileName
格式:文件名{workerId-时间戳}.jpg
例子:"5012832-1585879657703.jpg"
返回数据示例
{
"success": true,
"code": "0",
"message": "操作成功",
"data": {
"fileName": "u121.png",
"successKey": "worker/236606363873280/face/5000369-1585292468411.jpg"
}
}
success:true 表示上传成功,其它表示失败
查看刚刚上传的图片及下载照片
上传成功后会返回successKey字段,此为文件在云端存储的唯一标识,需要用此successKey再次发起请求才能获取近照图片
测试环境:https://aecloud-test.glodon.com/glm/services/download?key={successKey}
正式环境:https://xmgl.glodon.com/glm/services/download?key={successKey}
拼接此url在浏览器访问即可访问到图片