空教室查询API服务

服务地址: http://172.19.0.1:2512

学年学期: 2025-2026学年 第一学期

学期第一天: 2025-09-01

校区: 江浦校区

API端点

1. 健康检查

GET /health

2. 查询今天全天空教室 ⭐ 最快捷

分时段显示:1-2节、3-4节、5-6节、7-8节、9-10节

GET TXT /api/classroom/today?format=txt
GET JPG /api/classroom/today?format=jpg
GET JSON /api/classroom/today?format=json

3. 查询明天全天空教室 ⭐ 最实用

分时段显示:1-2节、3-4节、5-6节、7-8节、9-10节

GET TXT /api/classroom/tomorrow?format=txt
GET JPG /api/classroom/tomorrow?format=jpg
GET JSON /api/classroom/tomorrow?format=json

4. 直接访问图片 🖼️ 快速浏览

图片每天凌晨1点自动更新,可直接嵌入网页或分享

📅 今日空教室

GET JPG /today.jpg
今日空教室

💡 每天凌晨1点自动更新

明日空教室

GET JPG /tomorrow.jpg
明日空教室

💡 每次查询时更新

💡 使用示例:

• 直接分享链接:http://kjs.gdxz.top:2512/today.jpg

• 在网页中嵌入:<img src="http://kjs.gdxz.top:2512/today.jpg" />

• 移动端浏览:点击图片查看大图

5. 自定义查询空教室

GET /api/classroom?weeks=周次&weekdays=星期§ions=节次&format=格式

参数说明

参数 说明 示例 必填
weeks 周次(逗号分隔) 1 或 1,2,3
weekdays 星期(1-7,逗号分隔)
1=周一, 2=周二, ..., 7=周日
1,3,5
sections 节次(1-10,逗号分隔) 1,2,3,4
format 输出格式:json/txt/jpg txt 否(默认json)

节次对应时间

节次 时间
第1-2节08:10-09:50
第3-4节10:20-12:00
第5-6节14:00-15:40
第7-8节16:10-17:50
第9-10节19:00-20:40

💡 使用示例

示例1: 查询第16周周五下午(第5-8节)

示例2: 查询第1周周一上午(第1-4节)

示例3: 查询多个周次的工作日全天

示例4: 生成图片格式

输出格式

TXT格式示例:

周次: 16
星期: 周五
节次: 5-8
楼号: 厚学楼
空教室: 厚学楼200(多), 厚学楼201(多), 厚学楼300(多)
楼号: 进学楼
空教室: 进学楼101, 进学楼102
        

JSON格式示例:

{
  "code": 1000,
  "msg": "查询成功",
  "data": [
    {
      "week": 16,
      "weekdays": [5],
      "sections": [5, 6, 7, 8],
      "total": 121,
      "classrooms": [...]
    }
  ]
}
        

空教室查询API v1.0 |

如有问题,请联系293137746