Skip to content

上传人脸抓拍照片

接口地址: 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在浏览器访问即可访问到图片