接口文档格式

发表于 2020-01-01

考勤接口说明

获取 AccessToken

接口描述

获取 AccessToken。正常情况下AccessToken有效期为604800秒，出于系统维护需要，可能提前使AccessToken失效。开发者应实现AccessToken失效时重试获取的逻辑。

请求URL：

http://10.32.162.30/berserker-auth/oauth/token

请求方式：

POST

Header：

1 2	Content-Type:application/x-www-form-urlencoded Authorization:Basic YXR0ZW5kYW5jZV90aGlyZDphdHRlbmRhbmNlX3RoaXJkX3NlY3JldA==

Authorization是 base64 编码

参数：

参数名	必须	类型	说明
grant_type	是	String	固定值：”password”
scope	是	String	固定值：”all”
logintype	是	String	固定值：”operator”
username	是	String	用户名
password	是	String	密码

成功响应示例

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJ6aGFvbGFucWkiLCJhdmF0YXIiOiJkIiwiYXV0aG9yaXRpZXMiOlsiYWRtaW5pc3RyYXRvciJdLCJjbGllbnRfaWQiOiJhdHRlbmRhbmNlX3RoaXJkIiwib3BlcmF0b3IiOnsiaWQiOjExLCJhY2NvdW50Ijoiemhhb2xhbnFpIiwibmFtZSI6InpoYW9sYW5xaSIsInBhc3N3b3JkIjoiMjEyMThDQ0E3NzgwNEQyQkExOTIyQzMzRTAxNTExMDUiLCJzdGF0dXMiOiIxMTAwMDAwMDAwIiwiZGVzY3JpcHRpb24iOiLnrqHnkIblkZgiLCJlbXBsb3llZU5vIjpudWxsLCJkZXBhcnRtZW50Q29kZSI6IjEyMzQ1NiIsImNvbnRhY3ROdW1iZXIiOm51bGwsInFxIjpudWxsLCJlbWFpbCI6bnVsbCwiaXNBY2NvdW50TGlrZSI6IjAiLCJpc0VmZmVjdCI6bnVsbCwiaXNBZG1pbiI6bnVsbH0sInJvbGVfbmFtZSI6ImFkbWluaXN0cmF0b3IiLCJsaWNlbnNlIjoicG93ZXJlZCBieSBzeW4iLCJ1c2VyX2lkIjpudWxsLCJyb2xlX2lkIjpudWxsLCJzY29wZSI6WyJhbGwiXSwibmlja19uYW1lIjoiemhhb2xhbnFpIiwiZXhwIjoxNTc0Mzk0OTgxLCJqdGkiOiI5ODJmMTY2Zi01OWE0LTQ1N2MtODkxMC0wODNmZjU1MzA5MWQiLCJhY2NvdW50Ijoiemhhb2xhbnFpIn0.DbjJAvMcgOvJFN9pdNWC99RWg9k1RruG7cKDgOC4Zy0",
    "token_type": "bearer",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJ6aGFvbGFucWkiLCJhdmF0YXIiOiJkIiwiYXV0aG9yaXRpZXMiOlsiYWRtaW5pc3RyYXRvciJdLCJjbGllbnRfaWQiOiJhdHRlbmRhbmNlX3RoaXJkIiwib3BlcmF0b3IiOnsiaWQiOjExLCJhY2NvdW50Ijoiemhhb2xhbnFpIiwibmFtZSI6InpoYW9sYW5xaSIsInBhc3N3b3JkIjoiMjEyMThDQ0E3NzgwNEQyQkExOTIyQzMzRTAxNTExMDUiLCJzdGF0dXMiOiIxMTAwMDAwMDAwIiwiZGVzY3JpcHRpb24iOiLnrqHnkIblkZgiLCJlbXBsb3llZU5vIjpudWxsLCJkZXBhcnRtZW50Q29kZSI6IjEyMzQ1NiIsImNvbnRhY3ROdW1iZXIiOm51bGwsInFxIjpudWxsLCJlbWFpbCI6bnVsbCwiaXNBY2NvdW50TGlrZSI6IjAiLCJpc0VmZmVjdCI6bnVsbCwiaXNBZG1pbiI6bnVsbH0sInJvbGVfbmFtZSI6ImFkbWluaXN0cmF0b3IiLCJsaWNlbnNlIjoicG93ZXJlZCBieSBzeW4iLCJ1c2VyX2lkIjpudWxsLCJyb2xlX2lkIjpudWxsLCJzY29wZSI6WyJhbGwiXSwibmlja19uYW1lIjoiemhhb2xhbnFpIiwiYXRpIjoiOTgyZjE2NmYtNTlhNC00NTdjLTg5MTAtMDgzZmY1NTMwOTFkIiwiZXhwIjoxNTc0Mzk0OTgxLCJqdGkiOiI0YTk0NDhhMC1mMWZmLTRlZDItOWViYy00Y2Q0MmFkYmVmMTAiLCJhY2NvdW50Ijoiemhhb2xhbnFpIn0.Yg3fVrCuPfaGGkJTgwThoWdQIrxtJtgkqDhl84bjPtY",
    "expires_in": 604799,
    "scope": "all",
    "role_name": "administrator",
    "license": "powered by syn",
    "user_id": null,
    "role_id": null,
    "user_name": "username",
    "nick_name": "nicknmae",
    "avatar": "d",
    "client_id": "attendance_third",
    "account": "useraccount",
    "operator": {
        "id": 11,
        "account": "useraccount",
        "name": "username",
        "password": "69818CCA77804D2BA1965C33E0195455",
        "status": "1100000000",
        "description": "description",
        "employeeNo": null,
        "departmentCode": "123456",
        "contactNumber": null,
        "qq": null,
        "email": null,
        "isAccountLike": "0",
        "isEffect": null,
        "isAdmin": null
    },
    "jti": "982f166f-59a4-457c-8910-083ff553091d"
}

响应参数

参数名称	参数说明
access_token	获取到的凭证
expires_in	凭证的有效时间（秒）

获取周课表

接口描述

根据日期（格式：”2019-10-01”）获取所在周课表。

请求URL：

http://10.32.162.30/attendance-teacher/thirdParty/weekScheduleByDate

请求方式：

POST

Header：

1 2	Content-Type:application/json zhaolq-auth:bearer access_token # access_token 从接口获得

参数：

参数名	必须	类型	说明
lessonDate	是	String	课程日期，格式：”2019-10-01”

成功响应示例

{
    "code": 200,
    "success": true,
    "data": [
        {
            "ROOMNUM": 860,
            "TEACHERNAME": "王有腔",
            "LESSONDATE": "2019-11-09",
            "LESSONNAME": "自然辩证法概论",
            "TEACHERNUM": "0000010821",
            "CAMPUSNAME": "雁塔校区",
            "CAMPUSCODE": "2",
            "LESSONENDTIME": "17:30:00",
            "BUILDNUM": 96,
            "LESSONSTARTTIME": "14:30:00",
            "LESSONCODE": "141005",
            "BUILDNAME": "病理楼",
            "ROOMNAME": "病北",
            "LESSONSECTION": "5-7"
        },
        {
            "ROOMNUM": 5894,
            "TEACHERNAME": "陈腾",
            "LESSONDATE": "2019-11-08",
            "LESSONNAME": "基因组学",
            "TEACHERNUM": "0000010194",
            "CAMPUSNAME": "创新港",
            "CAMPUSCODE": "5",
            "LESSONENDTIME": "09:50:00",
            "BUILDNUM": 282,
            "LESSONSTARTTIME": "08:00:00",
            "LESSONCODE": "152014",
            "BUILDNAME": "20",
            "ROOMNAME": "4102",
            "LESSONSECTION": "1-2"
        }
    ],
    "msg": "操作成功"
}

响应参数

参数名称	参数说明
campusName	校区名称
campusCode	校区代码
buildName	楼栋名称
buildNum	楼栋编号
roomName	教室名称
roomNum	教室编号
teacherName	教师姓名
teacherNum	教师编号
lessonName	课程名称
lessonCode	课程代码
lessonDate	课程日期
lessonSection	课程节次
lessonStartTime	课程开始时间
lessonEndTime	课程结束时间

获取学生考勤统计

接口描述

获取学生考勤统计

请求URL：

http://10.32.162.30/attendance-teacher/thirdParty/attendanceBySubject

请求方式：

POST

Header：

1 2	Content-Type:application/json zhaolq-auth:bearer access_token # access_token 从接口获得

参数：

注意：lessonSubsection 和 dateTime 传一个值即可；若两个都传，lessonSubsection 无效。

参数名	必须	类型	说明
lessonDate	是	String	课程日期，格式：”2019-10-01”
dateTime	否	String	格式：”2019-10-01 08:00:00”，通过该值判断所处的小节次；若该时间点处于课间，将无结果返回。该值会使 lessonSubsection 无效。
lessonSubsection	否	Int	课程小节次，例如：第五节为 5
campusCode	否	String	校区代码
buildNum	否	String	楼栋编号
roomNum	否	String	教室编号
lessonCode	否	String	课程代码

成功响应示例


{
    "code": 200,
    "success": true,
    "data": [
        {
            "ROOMNUM": 5767,
            "TOTAL": 13,
            "TEACHERNAME": "吴华根",
            "LESSONDATE": "2019-11-19",
            "LESSONNAME": "压缩机机组性能优化技术",
            "TEACHERNUM": "0002005041",
            "CAMPUSNAME": "创新港",
            "CAMPUSCODE": "5",
            "LEAVECOUNT": 0,
            "NORMALCOUNT": 0,
            "ABSENCECOUNT": 13,
            "LESSONENDTIME": "22:30:00",
            "LATECOUNT": 0,
            "BUILDNUM": 281,
            "LESSONSTARTTIME": "19:40:00",
            "LESSONCODE": "032170",
            "BUILDNAME": "1",
            "ROOMNAME": "3056",
            "ACTUALCOUNT": 0,
            "LESSONSECTION": "9-11"
        },
        {
            "ROOMNUM": 5795,
            "TOTAL": 59,
            "TEACHERNAME": "席光",
            "LESSONDATE": "2019-11-19",
            "LESSONNAME": "流体力学的近代进展",
            "TEACHERNUM": "0000005752",
            "CAMPUSNAME": "创新港",
            "CAMPUSCODE": "5",
            "LEAVECOUNT": 0,
            "NORMALCOUNT": 0,
            "ABSENCECOUNT": 59,
            "LESSONENDTIME": "21:30:00",
            "LATECOUNT": 0,
            "BUILDNUM": 281,
            "LESSONSTARTTIME": "19:40:00",
            "LESSONCODE": "032012",
            "BUILDNAME": "1",
            "ROOMNAME": "6066",
            "ACTUALCOUNT": 0,
            "LESSONSECTION": "9-10"
        }
    ],
    "msg": "操作成功"
}

响应参数

参数名称	参数说明
campusName	校区名称
campusCode	校区代码
buildName	楼栋名称
buildNum	楼栋编号
roomName	教室名称
roomNum	教室编号
teacherName	教师姓名
teacherNum	教师编号
lessonName	课程名称
lessonCode	课程代码
lessonDate	课程日期
lessonSection	课程节次，例如：”7-8” 为7、8节课
lessonStartTime	课程开始时间
lessonEndTime	课程结束时间
total	应到（应到=正常+迟到+缺勤+请假）
actualCount	实到（实到=正常+迟到）
normalCount	正常
lateCount	迟到
absenceCount	缺勤
leaveCount	请假