校门门禁信息-实时
最近更新时间: 2023年06月26日 05时38分49秒
实时
描述
查询某一时间段内某一个人或者所有人的全部进出校流水信息,此接口为实时接口
支持的模式
客户端模式,授权码模式
请求方法
GET
请求地址
https://api.tongji.edu.cn/v1/rt/door/campus_access_control
数据来源
校园门禁系统
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 否 | 学工号,不传值代表所有人 |
portNum | 否 | 入校出校标识,1-”入门”,2-”出门”两种,不传值代表全部 |
dataStartTime | 否 | 开始时间 |
dataEndTime | 否 | 结束时间 |
sinceCardRecordID | 否 | 游标的起始位置,请把响应中的同字段传入,获取下一页,循环往复获取全量数据 |
返回参数
参数名 | 类型 | 备注 | 码表 |
---|---|---|---|
cardRecordID | numeric | 流水号 | |
userId | STRING | 学工号 | |
name | STRING | 姓名 | |
sex | STRING | 性别 | |
job | STRING | 身份 | |
equptId | STRING | 设备ID | |
equptName | STRING | 设备名称 | |
recordTime | STRING | 记录时间 | |
cardData | STRING | 记录卡号 | |
portNum | STRING | 录端口号,1-入门,2-出门 | |
PortNumName | STRING | 入、出门 | |
personnelId | STRING | 内部人员编号 | |
deptName | STRING | 部门名称 | |
campusId | STRING | 校区编号 | |
campusName | STRING | 校区名称 | |
lctnName | STRING | 安装位置名称 |
解释说明
1.1.当dataStartTime和dataEndTime不传值时,默认查询近一个月的校园门禁信息 1.2.当dataStartTime传值且dataEndTime不传值时,查询刷卡时间在dataStartTime和dataStartTime+30时间段内的校园门禁信息 1.3.当dataStartTime不传值且dataEndTime传值时,查询刷卡时间在dataEndTime-30和dataEndTime时间段内的校园门禁信息
请求示例
curl -X GET \
'https://api.tongji.edu.cn/v1/rt/door/campus_access_control' \
-H 'userId: ' \
-H 'portNum: ' \
-H 'dataStartTime: ' \
-H 'dataEndTime: ' \
-H 'sinceCardRecordID: '
返回示例
{
"code": "A00000",
"data": {
"count": 5,
"userInfos": [
{
"campusId": 204,
"campusName": "彰武路校区",
"cardData": "3********9",
"deptName": "建*******院",
"equptID": 2122,
"equptName": "彰武路正大门道闸进2",
"job": "0*",
"lctnName": "彰武路100号",
"name": "范*",
"personnelId": 3*****0,
"portNum": 1,
"portNumName": "入门",
"recordTime": "2023-03-10 23:43:37",
"sex": "女",
"userId": "2*****3"
},
{
"campusId": 196,
"campusName": "四平路校区",
"cardData": "3*****9",
"deptName": "建*******院",
"equptID": 2076,
"equptName": "正大门道闸进2",
"job": "0*",
"lctnName": "四平路1239号",
"name": "范*",
"personnelId": 3****0,
"portNum": 1,
"portNumName": "入门",
"recordTime": "2023-03-11 13:01:25.997",
"sex": "女",
"userId": "2*****3"
},
{
"campusId": 196,
"campusName": "四****区",
"cardData": "3******9",
"deptName": "建*****院",
"equptID": 2076,
"equptName": "正大门道闸进2",
"job": "0*",
"lctnName": "四平路1239号",
"name": "范*",
"personnelId": 3*******0,
"portNum": 1,
"portNumName": "入门",
"recordTime": "2023-03-11 13:41:46",
"sex": "女",
"userId": "2032113"
},
{
"campusId": 204,
"campusName": "彰武路校区",
"cardData": "3********9",
"deptName": "建筑与城市规划学院",
"equptID": 2122,
"equptName": "彰武路正大门道闸进2",
"job": "0*",
"lctnName": "彰武路100号",
"name": "范*",
"personnelId": 3*******0,
"portNum": 1,
"portNumName": "入门",
"recordTime": "2023-03-11 17:58:09",
"sex": "女",
"userId": "2******3"
},
{
"campusId": 196,
"campusName": "四平路校区",
"cardData": "3******9",
"deptName": "建筑与城市规划学院",
"equptID": 2082,
"equptName": "正大门道闸进3",
"job": "0*",
"lctnName": "四平路1239号",
"name": "范*",
"personnelId": 3*****0,
"portNum": 1,
"portNumName": "入门",
"recordTime": "2023-03-12 09:54:28",
"sex": "女",
"userId": "2*****3"
}
]
},
"msg": "成功"
}