对接说明

必读信息:

  • 请求接口前,需使用appId、appSecret请求登陆。
  • 所有接口需在头部加入内容 X-Requested-With: XMLHttpRequest
  • 除登陆外其他接口需在头部加入登陆返回token, 需权限验证, 验证方式为头部添加: Authorization: Bearer[空格] + token

本示例文档中的appId、appSecret、token 与接口地址(http://open.taisau.com)均为示例地址,实际地址根据项目而定。

根据类型/获取分组信息

根据类型(userType参数)获取分组信息
userType参数值: normal=>员工,,visitor=>访客,blacklist=>黑名单,student=>学生,teacher=>教师

接口URL

http://open.taisau.com/depart?pageSize=200&resultTree=true&whereFor[userType]=normal

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

响应参数

参数 参数描述
0 -
0.id ID
0.parentId 上一层ID
0.geneCode 基因代码
0.compId 机构ID
0.ruleId 考勤规则ID
0.userType 人员类型
0.name 部门名称
0.nameLetter 名称字母
0.departType 部门类型
0.enterYear 加入年份
0.created_at 创建时间
0.children 下一层节点
0.children.id ID
0.children.parentId 上一层ID
0.children.geneCode 基因代码
0.children.compId 机构ID
0.children.ruleId 考勤规则ID
0.children.userType 人员类型
0.children.name 部门名称
0.children.nameLetter 名称字母
0.children.departType 部门类型
0.children.enterYear 加入年份
0.children.created_at 创建时间
0.children.children 下一层节点
1 -
1.id ID
1.parentId 上一层ID
1.geneCode 基因代码
1.compId 机构ID
1.ruleId 考勤规则ID
1.userType 人员类型
1.name 部门名称
1.nameLetter 名称字母
1.departType 部门类型
1.enterYear 加入年份
1.created_at 创建时间
1.children 下一层节点

成功响应示例

[
    {
        "id": 586,
        "parentId": 0,
        "geneCode": "",
        "compId": 67,
        "ruleId": null,
        "userType": "normal",
        "name": "部门1",
        "nameLetter": "bm",
        "departType": "depart",
        "enterYear": null,
        "gradeCode": null,
        "classCode": null,
        "created_at": "2019-09-11 15:35:16",
        "children": [
            {
                "id": 587,
                "parentId": 586,
                "geneCode": "586,",
                "compId": 67,
                "ruleId": null,
                "userType": "normal",
                "name": "部门1-下一层",
                "nameLetter": "bmxyc",
                "departType": "depart",
                "enterYear": null,
                "gradeCode": null,
                "classCode": null,
                "created_at": "2019-09-11 15:35:26",
                "children": []
            }
        ]
    },
    {
        "id": 588,
        "parentId": 0,
        "geneCode": "",
        "compId": 67,
        "ruleId": null,
        "userType": "normal",
        "name": "部门2",
        "nameLetter": "bm",
        "departType": "depart",
        "enterYear": null,
        "gradeCode": null,
        "classCode": null,
        "created_at": "2019-09-11 15:35:32",
        "children": []
    }
]

获取所有考勤报表信息

接口URL

http://open.taisau.com/attendance-report?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.reportDate 考勤日期
data.identityId 平台身份ID
data.timeId 考勤时间段ID
data.recordIn 进-记录ID
data.recordOut 出-记录ID
data.inTime 进-时间
data.originInTime 进-原始时间
data.outTime 出-时间
data.originOutTime 出-原始时间
data.matchState 匹配状态
data.late 是否迟到
data.early 是否早退
data.workTime 工作时长
data.overTime 加班时长
data.lateTime 迟到时长
data.earlyTime 早退时长
data.reportWay 记录来源
data.manualId 变更人ID
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12121200,
            "compId": 67,
            "reportDate": "2019-08-12",
            "identityId": 12121208,
            "timeId": 12121200,
            "recordIn": null,
            "recordOut": 12121214,
            "inTime": null,
            "originInTime": null,
            "outTime": "2019-08-12 19:46:14",
            "originOutTime": "2019-08-12 18:55:20",
            "matchState": 0,
            "late": 0,
            "early": 0,
            "workTime": 0,
            "overTime": 6374,
            "lateTime": 0,
            "earlyTime": 0,
            "reportWay": "capture",
            "manualId": null,
            "created_at": "2019-08-12 14:57:26"
        },
        {
            "id": 12121201,
            "compId": 67,
            "reportDate": "2019-08-13",
            "identityId": 12121208,
            "timeId": 12121200,
            "recordIn": 12121217,
            "recordOut": null,
            "inTime": "2019-08-13 09:07:33",
            "originInTime": "2019-08-13 09:08:19",
            "outTime": null,
            "originOutTime": null,
            "matchState": 0,
            "late": 0,
            "early": 0,
            "workTime": 0,
            "overTime": 0,
            "lateTime": 0,
            "earlyTime": 0,
            "reportWay": "capture",
            "manualId": null,
            "created_at": "2019-08-13 09:21:53"
        },
        {
            "id": 12121202,
            "compId": 67,
            "reportDate": "2019-08-14",
            "identityId": 12121208,
            "timeId": 12121200,
            "recordIn": 12123406,
            "recordOut": 12123408,
            "inTime": "2019-08-14 09:42:45",
            "originInTime": null,
            "outTime": "2019-08-14 16:51:20",
            "originOutTime": null,
            "matchState": 0,
            "late": 1,
            "early": 1,
            "workTime": 25715,
            "overTime": 0,
            "lateTime": 2000,
            "earlyTime": -4000,
            "reportWay": "capture",
            "manualId": null,
            "created_at": "2019-08-14 09:42:50"
        },
        {
            "id": 12121203,
            "compId": 67,
            "reportDate": "2019-08-15",
            "identityId": 12121208,
            "timeId": 12121200,
            "recordIn": 12123410,
            "recordOut": null,
            "inTime": "2019-08-15 09:06:23",
            "originInTime": "2019-08-15 09:06:36",
            "outTime": null,
            "originOutTime": null,
            "matchState": 0,
            "late": 0,
            "early": 0,
            "workTime": 0,
            "overTime": 0,
            "lateTime": 0,
            "earlyTime": 0,
            "reportWay": "capture",
            "manualId": null,
            "created_at": "2019-08-15 09:06:39"
        },
        {
            "id": 12121204,
            "compId": 67,
            "reportDate": "2019-08-21",
            "identityId": 12121206,
            "timeId": 12121205,
            "recordIn": 12123414,
            "recordOut": null,
            "inTime": "2019-08-20 16:32:23",
            "originInTime": null,
            "outTime": null,
            "originOutTime": null,
            "matchState": 0,
            "late": 0,
            "early": 0,
            "workTime": 0,
            "overTime": 5257,
            "lateTime": 0,
            "earlyTime": 0,
            "reportWay": "capture",
            "manualId": null,
            "created_at": "2019-08-19 16:51:39"
        }
    ],
    "from": 1,
    "last_page": 2,
    "to": 5,
    "total": 8
}

获取设备列表

获取平台设备信息

接口URL

http://open.taisau.com/attendance-device?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$u.laRGTs8IzoT2knWz/wSOVc4yxuVpel4eY.rtpM4cs37pp17djLy 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式
X-Domain-With Open 必填 -

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.intype 设备进出类型
data.name 测试设备
data.secret 加密信息
data.sign 设备注册号
data.type 设备类型
data.listType 设备关联名单类型
data.address 设备地址
data.disable 是否启用
data.online 是否在线
data.heartTime 心跳-时间
data.heartIp 心跳-IP
data.heartCount 心跳-次数
data.issueCount 下发人数
data.issueSuccess 下发成功人数
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12121205,
            "compId": 67,
            "intype": "inout",
            "name": "测试设备",
            "secret": "ECBC85AC75AB48EA8B54B22BADF8D7E2",
            "sign": null,
            "type": "taisau_window",
            "listType": "company",
            "address": "公司",
            "disable": "enable",
            "online": "offline",
            "heartTime": null,
            "heartIp": null,
            "heartCount": 0,
            "issueCount": 167,
            "issueSuccess": 167,
            "teamNumber": null,
            "created_at": "2019-08-30 16:18:54"
        }
    ],
    "from": 1,
    "last_page": 1,
    "to": 1,
    "total": 1
}

获取所有考勤记录信息

接口URL

http://open.taisau.com/attendance-record?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$k8mDxxTyBlXt8MAQiBkE3OfEWeShYeA3cPcUaVxhX5kzVntgaszH2 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.deviceId 设备ID
data.intype 进出类型
data.identityId 平台身份ID
data.personId 上传身份ID
data.captureImage 抓拍-照片
data.captureDate 2020-02-14
data.captureTime 抓拍-时间
data.captureScore 抓拍-分数
data.captureStatus 抓拍-状态
data.sex 分析-性别
data.age 分析-年龄
data.temperature 检测体温信息
data.abnormal 体温是否异常
data.quality 分析-清晰度
data.hasGlass 分析-是否带眼睛
data.hasHat 分析-是否带帽子
data.hasMask 分析-是否带口罩
data.idCard 刷卡-身份证
data.icCard 刷卡-IC卡
data.cardNumber 证件-号码
data.cardName 证件-姓名
data.cardPicture 证件-照片
data.cardSex 证件-性别
data.cardBitrhday 证件-生日
data.cardNation 证件-籍贯
data.cardAdress 证件-地址
data.cardDepart 证件-机构
data.cardStart 证件-有效期
data.cardEnd 证件-失效期
data.mark 记录-备注
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12121219,
            "compId": 67,
            "deviceId": 12121201,
            "intype": "inout",
            "identityId": 12580,
            "personId": 12580,
            "captureImage": "attendance-record\/2019-08-13\/67\/UUpHMiCnq3A1tgl5NVO6qlhfJv8HYyH5axVhKhHP.jpeg",
            "captureTime": "2019-08-10 12:20:57",
            "captureScore": "89.55",
            "captureStatus": 0,
            "sex": null,
            "age": null,
            "temperature": "36.8",
            "quality": null,
            "hasGlass": "0",
            "hasHat": "0",
            "hasMask": "0",
            "idCard": null,
            "icCard": null,
            "cardNumber": null,
            "cardName": null,
            "cardPicture": null,
            "cardSex": null,
            "cardBitrhday": null,
            "cardNation": null,
            "cardAdress": null,
            "cardDepart": null,
            "cardStart": null,
            "cardEnd": null,
            "mark": 0,
            "created_at": "2019-08-13 16:09:20"
        },
        {
            "id": 12121220,
            "compId": 67,
            "deviceId": 12121201,
            "intype": "inout",
            "identityId": 12580,
            "personId": 12580,
            "captureImage": "attendance-record\/2019-08-13\/67\/7tckdqUiVNVT1ip0QU8MTAfuPsLh5EXMDYvd1bli.jpeg",
            "captureTime": "2019-08-10 12:20:57",
            "captureScore": "89.55",
            "captureStatus": 0,
            "sex": null,
            "age": null,
            "temperature": "36.8",
            "quality": null,
            "hasGlass": "0",
            "hasHat": "0",
            "hasMask": "0",
            "idCard": null,
            "icCard": null,
            "cardNumber": null,
            "cardName": null,
            "cardPicture": null,
            "cardSex": null,
            "cardBitrhday": null,
            "cardNation": null,
            "cardAdress": null,
            "cardDepart": null,
            "cardStart": null,
            "cardEnd": null,
            "mark": 0,
            "created_at": "2019-08-13 16:09:22"
        },
        {
            "id": 12121221,
            "compId": 67,
            "deviceId": 12121201,
            "intype": "inout",
            "identityId": 12580,
            "personId": 12580,
            "captureImage": "attendance-record\/2019-08-13\/67\/6MS8Dnap9941F5cqvFtkj4hx8l3EG6S6tzgCBAUw.jpeg",
            "captureTime": "2019-08-10 12:20:57",
            "captureScore": "89.55",
            "captureStatus": 0,
            "sex": null,
            "age": null,
            "temperature": "36.8",
            "quality": null,
            "hasGlass": "0",
            "hasHat": "0",
            "hasMask": "0",
            "idCard": null,
            "icCard": null,
            "cardNumber": null,
            "cardName": null,
            "cardPicture": null,
            "cardSex": null,
            "cardBitrhday": null,
            "cardNation": null,
            "cardAdress": null,
            "cardDepart": null,
            "cardStart": null,
            "cardEnd": null,
            "mark": 0,
            "created_at": "2019-08-13 16:09:24"
        },
        {
            "id": 12121222,
            "compId": 67,
            "deviceId": 12121201,
            "intype": "inout",
            "identityId": 12580,
            "personId": 12580,
            "captureImage": "attendance-record\/2019-08-13\/67\/Ta57CLCtpNinWrCNSaN91jaVI9GwRin0gIgohTox.jpeg",
            "captureTime": "2019-08-10 12:20:57",
            "captureScore": "89.55",
            "captureStatus": 0,
            "sex": null,
            "age": null,
            "temperature": "36.8",
            "quality": null,
            "hasGlass": "0",
            "hasHat": "0",
            "hasMask": "0",
            "idCard": null,
            "icCard": null,
            "cardNumber": null,
            "cardName": null,
            "cardPicture": null,
            "cardSex": null,
            "cardBitrhday": null,
            "cardNation": null,
            "cardAdress": null,
            "cardDepart": null,
            "cardStart": null,
            "cardEnd": null,
            "mark": 0,
            "created_at": "2019-08-13 16:09:26"
        },
        {
            "id": 12121223,
            "compId": 67,
            "deviceId": 12121201,
            "intype": "inout",
            "identityId": 12580,
            "personId": 12580,
            "captureImage": "attendance-record\/2019-08-13\/67\/aOfwyeKcCiySmKccdbbvGU3jIYRS1LDhmmLH3Obm.jpeg",
            "captureTime": "2019-08-10 12:20:57",
            "captureScore": "89.55",
            "captureStatus": 0,
            "sex": null,
            "age": null,
            "temperature": "36.8",
            "quality": null,
            "hasGlass": "0",
            "hasHat": "0",
            "hasMask": "0",
            "idCard": null,
            "icCard": null,
            "cardNumber": null,
            "cardName": null,
            "cardPicture": null,
            "cardSex": null,
            "cardBitrhday": null,
            "cardNation": null,
            "cardAdress": null,
            "cardDepart": null,
            "cardStart": null,
            "cardEnd": null,
            "mark": 0,
            "created_at": "2019-08-13 16:09:28"
        }
    ],
    "from": 1,
    "last_page": 438,
    "to": 5,
    "total": 2187
}

请求登陆、接口权限验证

请求接口前,需请求登陆,以获取后续接口权限
appId、appSecret 为机构对应的接口验证信息,请求成功返回token
接口地址(http://open.taisau.com)为本地测试地址,实际地址根据项目情况改变

接口URL

http://open.taisau.com/login?appId=5EC55E5D8D4B471EA85CCD3A0A28DE6F&appSecret=07503FD4D0EB420E816B3557F47535EE

请求方式

POST

请求 Content-Type

multipart/form-data

请求自定义Header

参数 示例值 必填 参数描述
X-Requested-With XMLHttpRequest 必填 -

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
appId 5EC55E5D8D4B471EA85CCD3A0A28DE6F 必填 -
appSecret 07503FD4D0EB420E816B3557F47535EE 必填 -

响应参数

参数 参数描述
id 记录ID
roleId 权限ID
compId 机构ID
name 名称
username 用户名
avatar 头像
created_at 创建时间
token 验证token

成功响应示例

{
    "id": 26,
    "roleId": null,
    "super": 0,
    "platform": 0,
    "manager": 1,
    "compId": 82,
    "name": "校园大道",
    "username": "13888888888",
    "avatar": null,
    "created_at": "2019-09-09 11:36:30",
    "token": "$2y$10$VrHtAY.0deg.XS02G\/MymeyFjBD.24dnKnjpjI1brVUp1toVwA4nC"
}

图片上传接口

接口URL

http://open.taisau.com/upload-file

请求方式

POST

请求 Content-Type

multipart/form-data

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$JwYrVIhzrNuYk5cDanbeN.HZXVzgU7PTGIqdld6l.CzuNoqVqczAC 必填 -
X-Requested-With XMLHttpRequest 必填 -

请求Body参数

参数 示例值 必填 参数描述
file - 必填 -

请求Query参数

参数 示例值 必填 参数描述

响应参数

参数 参数描述
data file-upload/2019-09-28/67/LkVlDaK0XKntiZYuotldb6r49dY08CYcOHReVn0C.jpeg
code -
message -
success -

成功响应示例

{
    "data": "file-upload\/2019-09-28\/67\/LkVlDaK0XKntiZYuotldb6r49dY08CYcOHReVn0C.jpeg",
    "code": 0,
    "message": null,
    "success": true
}

根据类型/新增分组

根据类型(userType参数)添加分组信息
userType参数值: normal=>员工,,visitor=>访客,blacklist=>黑名单,student=>学生,teacher=>教师

接口URL

http://open.taisau.com/depart

请求方式

POST

请求 Content-Type

application/json

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$s4coTaYdCHVQRqb99t8x6OYfbEZLKhptr7zPwIeg4mEReRJDABCXm 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

{
    "name": "员工分组1",
    "userType": "normal",
    "parentId": 0
}

响应参数

参数 参数描述
name 员工分组1
userType 人员类型
parentId 上级分组ID
compId 机构ID
geneCode -
nameLetter ygfz
created_at 创建时间
id ID

成功响应示例

{
    "name": "员工分组1",
    "userType": "normal",
    "parentId": 0,
    "compId": 67,
    "geneCode": "",
    "nameLetter": "ygfz",
    "created_at": "2019-09-28 18:40:02",
    "id": 704
}

获取设备关联信息

获取设备与人员、分组关联信息

接口URL

http://open.taisau.com/attendance-device-assigns?page=1&pageSize=5&whereFor[deviceId]=9

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VrHtAY.0deg.XS02G/MymeyFjBD.24dnKnjpjI1brVUp1toVwA4nC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小
whereFor[deviceId - 必填 -

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.deviceId 设备ID
data.departId 关联部门
data.identityId 关联身份
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 137,
            "deviceId": 9,
            "departId": 99,
            "identityId": 99,
            "created_at": "2019-09-17 17:22:30"
        },
        {
            "id": 134,
            "deviceId": 9,
            "departId": 454,
            "identityId": null,
            "created_at": "2019-09-17 17:14:30"
        },
        {
            "id": 135,
            "deviceId": 9,
            "departId": 457,
            "identityId": null,
            "created_at": "2019-09-17 17:14:31"
        }
    ],
    "from": 1,
    "last_page": 1,
    "to": 3,
    "total": 3
}

根据类型/获取人员信息

根据类型(userType参数)获取人员信息
userType参数值: normal=>员工,,visitor=>访客,blacklist=>黑名单,student=>学生,teacher=>教师

接口URL

http://open.taisau.com/identity?page=1&pageSize=5&whereFor[userType]=normal&modelSee[0]=people.peopleInfo

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VrHtAY.0deg.XS02G/MymeyFjBD.24dnKnjpjI1brVUp1toVwA4nC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 -
pageSize 5 必填 -
whereFor[userType - 必填 -
modelSee[0 - 必填 -

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.userType 人员类型
data.peopleId 属性ID
data.postionId 职位ID
data.titleId 职称ID
data.departId 部门ID
data.roleId 角色ID
data.ruleId 考勤规则ID
data.number 编号
data.secret 加密信息
data.from 新增自
data.groupType 特殊组
data.employDate 入职日期
data.leaveDate 离职日期
data.startTime 有效期-开始时间
data.endTime 有效期-结束时间
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12560,
            "compId": 67,
            "userType": "teacher",
            "peopleId": 12349,
            "postionId": null,
            "titleId": null,
            "departId": 444,
            "roleId": null,
            "ruleId": null,
            "number": null,
            "secret": null,
            "from": "manage",
            "groupType": "normal",
            "employDate": "2019-03-08",
            "leaveDate": null,
            "startTime": null,
            "endTime": null,
            "created_at": "2019-08-28 15:37:41"
        },
        {
            "id": 12561,
            "compId": 67,
            "userType": "teacher",
            "peopleId": 35,
            "postionId": null,
            "titleId": null,
            "departId": 443,
            "roleId": null,
            "ruleId": null,
            "number": null,
            "secret": null,
            "from": "manage",
            "groupType": "normal",
            "employDate": "2015-09-30",
            "leaveDate": null,
            "startTime": null,
            "endTime": null,
            "created_at": "2019-08-28 15:37:41"
        },
        {
            "id": 12565,
            "compId": 67,
            "userType": "teacher",
            "peopleId": 45,
            "postionId": null,
            "titleId": null,
            "departId": 511,
            "roleId": null,
            "ruleId": null,
            "number": null,
            "secret": null,
            "from": "manage",
            "groupType": "normal",
            "employDate": "2019-05-20",
            "leaveDate": null,
            "startTime": null,
            "endTime": null,
            "created_at": "2019-08-28 15:37:42"
        },
        {
            "id": 12567,
            "compId": 67,
            "userType": "teacher",
            "peopleId": 32,
            "postionId": null,
            "titleId": null,
            "departId": 443,
            "roleId": null,
            "ruleId": null,
            "number": null,
            "secret": null,
            "from": "manage",
            "groupType": "normal",
            "employDate": "2019-03-08",
            "leaveDate": null,
            "startTime": null,
            "endTime": null,
            "created_at": "2019-08-28 15:37:43"
        },
        {
            "id": 12570,
            "compId": 67,
            "userType": "teacher",
            "peopleId": 12350,
            "postionId": null,
            "titleId": null,
            "departId": 444,
            "roleId": null,
            "ruleId": null,
            "number": null,
            "secret": null,
            "from": "manage",
            "groupType": "normal",
            "employDate": "2019-03-08",
            "leaveDate": null,
            "startTime": null,
            "endTime": null,
            "created_at": "2019-08-28 15:37:43"
        }
    ],
    "from": 1,
    "last_page": 55,
    "to": 5,
    "total": 272
}

获取所有考勤总计信息

接口URL

http://open.taisau.com/attendance-count?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.reportDate 考勤日期
data.identityId 平台身份ID
data.recordIn 进-记录ID
data.recordOut 出-记录ID
data.inTime 进-时间
data.outTime 出-时间
data.manualId 变更人ID
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12121202,
            "compId": 67,
            "reportDate": "2019-08-10",
            "identityId": 12580,
            "recordIn": 12121219,
            "recordOut": 12121220,
            "inTime": "2019-08-10 12:20:57",
            "outTime": "2019-08-10 12:20:57",
            "manualId": null,
            "created_at": "2019-08-13 16:09:20"
        },
        {
            "id": 12121203,
            "compId": 67,
            "reportDate": "2019-08-13",
            "identityId": 12580,
            "recordIn": 12121663,
            "recordOut": 12121313,
            "inTime": "2019-08-13 00:00:00",
            "outTime": "2019-08-13 13:08:56",
            "manualId": null,
            "created_at": "2019-08-13 16:18:24"
        },
        {
            "id": 12121204,
            "compId": 67,
            "reportDate": "2019-01-11",
            "identityId": 12580,
            "recordIn": 12122112,
            "recordOut": 12122118,
            "inTime": "2019-01-11 11:11:11",
            "outTime": "2019-01-11 11:11:11",
            "manualId": null,
            "created_at": "2019-08-13 16:47:17"
        },
        {
            "id": 12121205,
            "compId": 67,
            "reportDate": "2019-01-11",
            "identityId": 12560,
            "recordIn": 12122132,
            "recordOut": null,
            "inTime": "2019-01-11 11:11:11",
            "outTime": null,
            "manualId": null,
            "created_at": "2019-08-13 16:47:53"
        },
        {
            "id": 12121206,
            "compId": 67,
            "reportDate": "2019-01-11",
            "identityId": 12561,
            "recordIn": 12122157,
            "recordOut": 12122175,
            "inTime": "2019-01-11 11:11:11",
            "outTime": "2019-01-11 11:11:11",
            "manualId": null,
            "created_at": "2019-08-13 16:48:44"
        }
    ],
    "from": 1,
    "last_page": 3,
    "to": 5,
    "total": 11
}

修改分组信息

接口URL

http://open.taisau.com/depart/704

请求方式

PUT

请求 Content-Type

application/json

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$s4coTaYdCHVQRqb99t8x6OYfbEZLKhptr7zPwIeg4mEReRJDABCXm 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

{
    "name": "员工分组2",
    "userType": "normal"
}

响应参数

参数 参数描述
id ID
parentId -
geneCode -
compId 机构ID
ruleId 考勤规则ID
userType 人员类型
name 员工分组2
nameLetter ygfz
departType depart
enterYear -
gradeCode -
classCode -
created_at 2019-09-11 14:59:01

成功响应示例

{
    "id": 704,
    "parentId": 0,
    "geneCode": "",
    "compId": 67,
    "ruleId": null,
    "userType": "normal",
    "name": "员工分组2",
    "nameLetter": "ygfz",
    "departType": "depart",
    "enterYear": null,
    "gradeCode": 0,
    "classCode": 0,
    "created_at": "2019-09-28 18:40:02"
}

添加设备关联信息

添加设备与人员、分组关联信息

接口URL

http://open.taisau.com/attendance-device-assigns

请求方式

POST

请求 Content-Type

multipart/form-data

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VrHtAY.0deg.XS02G/MymeyFjBD.24dnKnjpjI1brVUp1toVwA4nC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述
deviceId 9 必填 -
identityId 100 必填 -
departId 77 必填 -

响应参数

参数 参数描述
deviceId 设备ID
identityId 身份ID
departId 部门ID
created_at 创建时间
id ID

成功响应示例

{
    "deviceId": "9",
    "identityId": "100",
    "departId": "77",
    "created_at": "2019-09-17 17:27:21",
    "id": 139
}

获取所有考勤排名信息

接口URL

http://open.taisau.com/attendance-ranking?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.compId 机构ID
data.reportDate 考勤日期
data.departId 排名-部门
data.identityCount 总人数
data.recordCount 考勤人数
data.recordRate 出勤率
data.lateCount 迟到人数
data.lateRate 迟到率
data.earlyCount 早退人数
data.earlyRate 早退率
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 12121200,
            "compId": 67,
            "reportDate": "2019-09-11",
            "departId": 45,
            "identityCount": 100,
            "recordCount": 65,
            "recordRate": "0.65",
            "lateCount": 10,
            "lateRate": "0.10",
            "earlyCount": 10,
            "earlyRate": "0.10",
            "created_at": null
        }
    ],
    "from": 1,
    "last_page": 1,
    "to": 1,
    "total": 1
}

获取所有请假信息

接口URL

http://open.taisau.com/attendance-dayoff?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.identityId 人员/身份ID
data.compId 机构ID
data.type 设备类型
data.reason 原因
data.startTime 开始时间
data.endTime 结束时间
data.days 天数
data.images 图片
data.approverId 审核人
data.state 审核状态
data.comments 审核意见
data.approvalTime 审核时间
data.carbonId 抄送给
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "identityId": 12561,
            "compId": 67,
            "type": "other",
            "reason": "因身体微恙,需请假一天",
            "startTime": "2019-09-11 08:00:00",
            "endTime": "2019-09-11 18:00:00",
            "days": "1.0",
            "images": null,
            "approverId": null,
            "state": "wait",
            "comments": null,
            "approvalTime": null,
            "carbonId": null,
            "created_at": null
        }
    ],
    "from": 1,
    "last_page": 1,
    "to": 1,
    "total": 1
}

删除分组信息

接口URL

http://open.taisau.com/depart/704

请求方式

DELETE

请求 Content-Type

multipart/form-data

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$s4coTaYdCHVQRqb99t8x6OYfbEZLKhptr7zPwIeg4mEReRJDABCXm 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

响应参数

参数 参数描述
data 数据信息
code 接口返回码
message 接口返回信息
success 执行是否成功

成功响应示例

{
    "data": null,
    "code": 0,
    "message": null,
    "success": true
}

删除设备关联信息

删除设备与人员、分组关联信息

接口URL

http://open.taisau.com/attendance-device-assigns/136

请求方式

DELETE

请求 Content-Type

multipart/form-data

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$17Ij8iwNM2WuLIL4q6cJwOH/5pgtP/xAG3baMbiCQj8fTSPrfjxVa 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

响应参数

参数 参数描述
data 数据
code 返回代码
message 返回信息
success 成功状态

成功响应示例

{
    "data": null,
    "code": 0,
    "message": null,
    "success": true
}

获取所有外出信息

接口URL

http://open.taisau.com/attendance-leave?page=1&pageSize=5

请求方式

GET

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

请求Query参数

参数 示例值 必填 参数描述
page 1 必填 当前分页
pageSize 5 必填 分页大小

响应参数

参数 参数描述
current_page 分页-当前页
data 数据
data.id ID
data.identityId 人员/身份ID
data.compId 机构ID
data.type 设备类型
data.reason 原因
data.address 地址
data.startTime 开始时间
data.endTime 结束时间
data.days 天数
data.images 图片
data.approverId 审核人
data.state 审核状态
data.comments 审核意见
data.approvalTime 审核时间
data.carbonId 抄送给
data.created_at 创建时间
from 分页-记录索引-自
last_page 分页-最后一页
to 分页-记录索引-到
total 分页-总记录数

成功响应示例

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "identityId": 12561,
            "compId": 67,
            "type": "unknown",
            "reason": "去**大厦见客户",
            "address": "**大厦",
            "startTime": "2019-09-11 08:00:00",
            "endTime": "2019-09-11 14:00:00",
            "days": "0.5",
            "images": null,
            "approverId": null,
            "state": "wait",
            "comments": null,
            "approvalTime": null,
            "carbonId": null,
            "created_at": null
        }
    ],
    "from": 1,
    "last_page": 1,
    "to": 1,
    "total": 1
}

根据类型/新增人员

根据类型(userType参数)新增人员信息
userType参数值: normal=>员工,,visitor=>访客,blacklist=>黑名单,student=>学生,teacher=>教师

接口URL

http://open.taisau.com/identity

请求方式

POST

请求 Content-Type

application/json

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VrHtAY.0deg.XS02G/MymeyFjBD.24dnKnjpjI1brVUp1toVwA4nC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

{
    "departId": "",
    "people": {
        "name": "员工001",
        "phone": "13906060606",
        "sex": "male",
        "peopleInfo": {
            "idCard": "421253199909092222",
            "icCard": "",
            "picture": ""
        }
    },
    "userType": "normal"
}

响应参数

参数 参数描述
compId 机构ID
peopleId 信息ID
userType 人员类型
departId 部门ID
created_at 创建时间
id ID

成功响应示例

{
    "compId": 67,
    "peopleId": 12122516,
    "userType": "normal",
    "departId": null,
    "created_at": "2019-09-11 15:01:03",
    "id": 12122397
}

修改人员信息

接口URL

http://open.taisau.com/identity/12122396

请求方式

PUT

请求 Content-Type

application/json

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

{
    "departId": "",
    "people": {
        "name": "员工001",
        "phone": "13908080808",
        "sex": "male",
        "peopleInfo": {
            "idCard": "421253199909092222",
            "icCard": "",
            "picture": ""
        }
    },
    "userType": "normal"
}

响应参数

参数 参数描述
id ID
compId 机构ID
userType 人员类型
peopleId 信息ID
postionId 职位ID
titleId 职称ID
departId 部门ID
roleId 角色ID
ruleId 考勤规则ID
number 编号
secret 加密信息
from 新增自
groupType 特殊组
employDate 入职日期
leaveDate 离职日期
startTime 考勤有效日期
endTime 考勤过期日期
created_at 2019-09-11 14:59:01

成功响应示例

{
    "id": 12122396,
    "compId": 67,
    "userType": "normal",
    "peopleId": 12122515,
    "postionId": null,
    "titleId": null,
    "departId": null,
    "roleId": null,
    "ruleId": null,
    "number": null,
    "secret": null,
    "from": "manage",
    "groupType": "normal",
    "employDate": null,
    "leaveDate": null,
    "startTime": null,
    "endTime": null,
    "created_at": "2019-09-11 14:59:01"
}

删除人员信息

接口URL

http://open.taisau.com/identity/12122396

请求方式

DELETE

请求 Content-Type

Array

请求自定义Header

参数 示例值 必填 参数描述
Authorization Bearer $2y$10$VeKl4/XEyyPnOmYojec12e0RBG4fXdrdwK9wTh1CGjbGJ33V.CitC 必填 接口验证token
X-Requested-With XMLHttpRequest 必填 接口请求方式

请求Body参数

参数 示例值 必填 参数描述

响应参数

参数 参数描述
data 数据信息
code 接口返回码
message 接口返回信息
success 执行是否成功

成功响应示例

{
    "data": null,
    "code": 0,
    "message": null,
    "success": true
}