上报企业人员在设备的考勤打卡记录,每次可批量上报100条记录。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_checkin_data?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:
{
"checkin_data": [
{
"open_userid": "x1",
"user_type":0,
"timestamp": 12345
},
{
"open_userid": "x2",
"user_type":0,
"timestamp": 12345
}
]
}
参数说明:
参数名 | 是否必须 | 类型 | 描述 |
---|---|---|---|
device_access_token | 是 | string | device_access_token ,获取方式见获取设备调用凭证 |
checkin_data | 是 | array(data) | 打卡数据,最多批量上报100条数据 |
checkin_data.open_userid | 是 | string | 打卡用户的open_userid |
checkin_data.user_type | 是 | uint32 | 用户类型:0-企业成员;2-学生 |
checkin_data.timestamp | 是 | uint32 | 打卡时间戳 |
返回结果:
{
"errcode": 0,
"errmsg": "ok"
"fail_list": [
{
"open_userid":"x2",
"user_type":0,
"timestamp":12345
}
]
}
参数说明:
参数名 | 描述 |
---|---|
errcode | 错误码 |
errmsg | 错误码描述 |
fail_list | 上报失败列表 |