Skip to main content

一、基本信息​

接口名称：上传考勤数据接口

接口说明：班牌服务器定期上传给考勤服务器学生考勤数据，定时时间可调，每次上传不超过30条。

请求地址：${BASEURL}/dataconnectorserv/integration/classadmin/loadCheckings

请求方式：POST

请求类型：application/json

接口版本：2.0

修改日期：2023-11-17

小提示

接口超时时间设置尽量长一些，减少并发访问。

对接考勤数据接口时，请先阅读“服务能力->接入概述->场景说明”，课表与班牌集成和课表与考勤集成。

二、请求参数​

参数名类型是否必填说明
appKeyString是平台提供的唯一标识
schoolIDString是学校ID，从学校列表获取
serialString是调用序列号，调用方每次调用接口时加1，服务端会记录日志
dataArray是学生打卡数据
idString是刷卡记录编号，传唯一ID，排查错误日志
checkingTimeString是刷卡时间，传递时间要比正常北京时间要早八个小时
checkingStatusString是考勤状态：签到、迟到、签退，早退
studentEIDString是学生EID
studentNameString否学生姓名
classFullNameString否班级全称
classTypeString否班级类型：行政班或教学班
cardIDString否签到使用的卡号（支持考勤刷卡时需要）调查错误日志
locationIDString是教室ID
locationNameString是教室名称
deviceIDString否MAC地址，设备ID调查错误日志
picDataString否学生照片，刷卡时设备录制的照片base64编码
{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS==",
    "serial": "3",
    "data": [
        {
            "id": "123123123121231",
            "checkingTime": "2023-10-17T00:00:00.070Z",
            "checkingStatus": "签到",
            "studentEID": "5132022039",
            "studentName": "张继元",
            "classFullName": "高一1班",
            "classType": "教学班",
            "cardID": "",
            "locationID": "1",
            "locationName": "高一1班",
            "deviceID": "23:34:45:34:34:34",
            "picData": ""
        },
        {
            "id": "",
            "checkingTime": "2023-10-17T00:00:00.070Z",
            "checkingStatus": "签到",
            "studentEID": "5132022058",
            "studentName": "李妤佳",
            "classFullName": "高二1班",
            "classType": "行政班",
            "cardID": "",
            "locationID": "2",
            "locationName": "B501",
            "deviceID": "23:34:45:34:34:34",
            "picData": ""
        }
    ]
}

三、响应成功结果​

{
   "status":"success"
}

四、响应失败结果​

{
   "status":"fail",
   "errorMessage":"编号xxxxxx数据xxx字段错误，....",
   "errorRecords":[{"id":"xxxxxx", "errorMessage":"数据xxx字段格式错误"}]
}