人员汇总数据
最近更新时间: 2024年12月30日 09时33分13秒
数据中心
描述
根据学号和年份查询全校师生统计数据
支持的模式
客户端模式,授权码模式
请求方法
GET
请求地址
https://api.tongji.edu.cn/v1/dc/user/user_annual_bill
数据来源
教务系统,人员状态系统,图书馆系统,一卡通系统,校园门禁系统
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| userId | 是 | 学号 |
| year | 是 | 年份 |
返回参数
| 参数名 | 类型 | 备注 | 码表 |
|---|---|---|---|
| userId | STRING | 学工号 | |
| name | STRING | 姓名 | |
| deptCode | STRING | 学院代码 | |
| deptName | STRING | 学院代码名称 | |
| userTypeCode | STRING | 人员类型代码 | types |
| totalEntries | NUMBER | 进出校门总数 | |
| weeklyExitAvg | NUMBER | 平均每周出校门的次数 | |
| earliestExitTime | NUMBER | 最早出校门的准确时间（精确到秒） | |
| lateExitPct | NUMBER | 当天晚于最早出校门这一时间点出门的师生人数占当天出门师生总人数的X% | |
| latestExitTime | STRING | 最晚出校门的准确时间（精确到秒） | |
| todayLateExitPct | NUMBER | 当天晚于最晚出校门这个时间点出门的师生人数占当天出门师生总人数的X% | |
| libraryAccessCount | NUMBER | 进出图书馆次数 | |
| earliestEntryTime | STRING | 最早进入图书馆的具体时间（精确到秒） | |
| todayEntryCount | NUMBER | 当天最早进入图书馆这个时间点已有X师生在图书馆 | |
| libraryAttendancePct | NUMBER | 当天最早进入图书馆这个时间点的在馆师生人数占当天进馆师生总人数的X% | |
| latestDepartureTime | STRING | 最晚离开图书馆的时间（精确到秒） | |
| lastDepartureCount | NUMBER | 当天最晚离开图书馆这个时间点还有X师生在图书馆 | |
| libraryExitPct | NUMBER | 当天最晚离开图书馆这个时间点的仍在馆的师生人数占当天进馆师生总人数的X% | |
| libraryStudyTime | NUMBER | 在图书馆学习时长，单位：小时 | |
| libraryStudyTopPct | NUMBER | 在图书馆学习时间位于全校师生前X% | |
| booksCount | NUMBER | 一年中的总借书数 | |
| annualBorrowedTopPct | NUMBER | 一年中的总借书数是全校师生的前X% | |
| totalSpendingCanteen | NUMBER | 全年消费总金额（食堂里），单位：元 | |
| avgDailySpending | NUMBER | 平均每天消费金额（食堂里），单位：元 | |
| canteenSpendingPct | NUMBER | 食堂总消费金额超过于全校老师/学生的X% | |
| shuttleRidesCount | NUMBER | 校车乘坐次数（年度） | |
| maxTransactionTime | STRING | 单次消费最多的时间（年月日） | |
| maxTransactionLoc | NUMBER | 单次消费最多的地点（食堂名） | |
| maxTransactionAmt | NUMBER | 单次消费最多金额，单位：元 | |
| maxCumulativeLoc | STRING | 累计消费最多的地点（食堂名） | |
| maxCumulativeAmt | NUMBER | 累计消费最多的地点总计消费金额，单位：元 | |
| year | STRING | 年份 |
解释说明
一、最早离校出门与最晚离校出门调整：
1）当天时间定义：T 05:00:00 至T+1 04:59:59为T日
2）占比计算：分子为当天为晚于此时间点的人数，分母为当天离校出门的总人数
二、最早进馆与最晚离馆调整：
1）当天时间定义：00:00:00至23:59:59为T日
2）进馆时在馆人数：当天进馆时间点 之前出馆记录数 减去 进馆记录数，若结果为负数默认为0
3）占比计算：分子为进馆时在馆人数，分母为当天进馆人数
三、计算在馆时间口径：
1）只有进馆，没有出馆，默认出馆时间为23:59:59，计算时间差
2）只有出馆，没有进关，默认进馆时间为07:00:00，计算时间差
3）有进馆，有出馆，计算两个时间差
4）并汇总个人所有的进出记录的时间差，为在馆学习时间
请求示例
curl -X GET \
'https://api.tongji.edu.cn/v1/dc/user/user_annual_bill' \
-H 'userId: ' \
-H 'year: ' 返回示例
{
"code": "A00000",
"data": [
{
"annualBorrowedTopPct": 49.3,
"avgDailySpending": 12.7,
"booksCount": 3,
"canteenSpendingPct": 4.71,
"deptCode": "000170",
"deptName": "机械与能源工程学院",
"earliestEntryTime": "2024-10-15 07:30:30",
"earliestExitTime": "2024-03-06 08:58:13",
"lastDepartureCount": 1635,
"lateExitPct": 92.13,
"latestDepartureTime": "2024-02-28 21:40:01",
"latestExitTime": "2024-04-27 01:33:26",
"libraryAccessCount": 76,
"libraryAttendancePct": 0.14,
"libraryExitPct": 19.01,
"libraryStudyTime": 143.41,
"libraryStudyTopPct": 80.7,
"maxCumulativeAmt": 43.88,
"maxCumulativeLoc": "嘉定校区嘉苑饮食广场快餐二部",
"maxTransactionAmt": 18.0,
"maxTransactionLoc": "嘉定校区嘉苑饮食广场快餐二部",
"maxTransactionTime": "2024-05-28",
"name": "刘**",
"shuttleRidesCount": 0,
"todayEntryCount": 32,
"todayLateExitPct": 0.36,
"totalEntries": 77,
"totalSpendingCanteen": 50.78,
"userId": "1*****0",
"userTypeCode": "4",
"weeklyExitAvg": 1.68,
"year": "2024"
}
],
"msg": "操作成功"
}