API开发文档 - 道一云

开发说明

开发说明

功能说明：接入方调用接口实现虚拟打卡前，前往道一云管理后台绑定对应的规则机器，否则调用打卡将不能正确处理数据
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/checkwork/addVirtualDeviceCheck.do?token=token&corpId=corpId

请求包体：

{
    "userCheckList": [
        {
            "deviceId": "318e2f3d-bf5d-4947-9654-60ad141497b5",
            "checkTime": "20180123183100",
            "wxUserId": "zhangsan"
        },
        {
            "deviceId": "318e2f3d-bf5d-4947-9654-60ad141497b5",
            "checkTime": "20180123183102",
            "wxUserId": "lisi"
        }
    ]
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是
corpId	公司唯一标识	String	是
userCheckList	打卡列表	String[]	是	按考勤时间自然排序，每次上传不超过100条
deviceId	考勤机id	String	是	注册考勤机接口获取
checkType	打卡方式	String	否	0 指纹 1 密码 2 人脸 3 卡片默认0 指纹
checkTime	考勤时间	String	是	格式： yyyyMMddHHmmss 打卡时间控制为服务器时间前三个月和后半小时之内合法，请确保考勤时间的合法性
wxUserId	机构人员的帐号	String	是	wxUserId 人员帐号通过通讯录变更同步接口获取

备注1：

打卡时间控制为服务器时间前三个月和后半小时之内合法，请确保考勤时间的合法性

备注2：

wxUserId 通讯录变更同步接口获取到用户对应的帐号信息，接入方应当定期调用该接口维护当前对应的打卡人员信息

返回结果：

{
    "code": "26018",
    "desc": "考勤结果异常",
    "data": {
        "errorList": [
            {
                "bindRule":false,
                "deviceIdExist": false,
                "index": 0,
                "wxUserIdExist": true
            }
        ]
    }
}

返回参数说明：

参数	说明
code	0 成功（处理完毕所有数据） 26018打卡数据异常（所有或者部分数据未处理成功，建议记录返回的errorList）其他编码（其他异常，数据不处理）
errorList	wxUserId或者deviceId不存在或者未绑定规则则返回错误列表
index	入参的下标
deviceIdExist	机器id是否正确 true 正确 false错误
wxUserIdExist	wxUserId是否正确 true 正确 false错误
bindRule	人员机器未绑定考勤规则，需要在后台绑定是否绑定 true 已绑定 false未绑定

企业微信

考勤机打卡

开发说明