纪律星接口开发文档

前言

本文档针对需要对接纪律星模块的平台而编写。

接入纪律星模块的平台需要先联系知未科技研发，获取2个基本参数：平台ID[platform]，平台密钥[key]。这两个参数也可以反过来向知未科技提供。

然后提供一个接口URL前缀[platformBaseUrl]，后面所有的接口都基于这个前缀。凡是接口URL是[serverBaseUrl]前缀的，说明这个接口由第三方向纪律星发起请求。而如果接口URL前缀是[platformBaseUrl]，说明接口是由纪律星向第三方发起请求。

查询用户

查询考勤异常记录

此接口由成绩云向第三方发起请求，获取考勤异常记录。

接口说明

请求方式：POST
请求URL:[platformBaseUrl]/query
请求参数:

参数	类型	是否必填	描述
begintime	int	是	时间戳（Unixtime）
endtime	int	是	时间戳（Unixtime）
sign	string	是	签名。详见附录签名参数sign生成说明

返回参数:

参数	类型	描述
id	string	记录ID，用于确认记录是否已经导入过。
grade	string	年级
class	string	班别
name	string	姓名
time	int	记录事件发生时间戳（Unixtime），相当于打卡时间。
event	string	事件。例如“异常”、“晚归“、“迟到”、“未到寝“。

返回样例

{
    "code": 200,
    "msg": "ok",
    "data": [
        {
            "id": 100231,
            "grade": "高一",
            "class": "1",
            "name": "张三",
            "time": 1639016550,
            "event": “迟到”,
        },
        {
            "id": 100234,
            "grade": "高一",
            "class": "2",
            "name": "李四",
            "time": 1639016555,
            "event": "未到寝",
        },
    ]
}