曲阜师范大学图书馆预约系统 API 逆向文档

Step 1: 获取 IDS 登录页#

从 HTML 中正则提取两个参数：

• id="pwdEncryptSalt" value="..." → salt（用于密码加密的 AES 密钥）
• name="execution" value="..." → execution（登录表单必需参数）

Step 1.5: 滑块验证码（按需触发）#

并非每次登录都要求滑块验证，需探测式处理。

1
{
2
  "bigImage": "<base64 编码的缺口背景图>",
3
  "smallImage": "<base64 编码的滑块小块图>"
4
}

1
{
2
  "canvasLength": 280,
3
  "moveLength": <移动距离（px）>,
4
  "tracks": [
5
    {"a": <累计x位移>, "b": <累计y偏移>, "c": <时间间隔(ms)>},
6
    ...
7
  ]
8
}

Step 2: 提交 IDS 登录#

请求体（form 字段）：

密码加密方案（AES-128-CBC）：

• Key = Step 1 提取的 salt
• IV = 随机 16 字符
• 明文 = 64 字符随机前缀 + 原始密码
• PKCS7 填充 → Base64 编码

成功响应： HTTP 302，Location 头指向图书馆 CAS 回调地址。

Step 3-4: CAS 重定向#

Step 4 返回 HTTP 302，从响应的 Location 头末尾 32 个字符提取 CAS Token。

Step 5: 换取 Bearer Token#

请求体：

1
{"cas": "<32位CAS Token>"}

成功响应：

1
{
2
  "code": 1,
3
  "member": {
4
    "name": "用户名",
5
    "token": "<Bearer Token>"
6
  },
7
  "msg": "..."
8
}

• 返回的 member.token 即为后续所有业务接口使用的 Bearer Token。
• 实测 Token 有效期约 90-100 分钟。
• 整个认证到业务请求链路必须共用同一个 HTTP Cookie Jar（重定向不自动跟随，需手动提取 Location）。

5.1 获取校区/楼宇/区域#

获取三级层级结构（校区 → 楼层 → 区域）及可用日期列表。

请求体：

1
{
2
  "id": "1",
3
  "date": "2026-07-05",
4
  "categoryIds": ["1"],
5
  "members": 0,
6
  "authorization": ""
7
}

成功响应（code 为字符串 "0"，注意与其他接口不同）：

1
{
2
  "code": "0",
3
  "data": {
4
    "date": ["2026-07-05", "2026-07-06"],
5
    "premises": [
6
      {
7
        "id": "1",
8
        "name": "曲阜校区",
9
        "nameMerge": "",
10
        "parentId": "0",
11
        "topId": "1",
12
        "total_num": 1200,
13
        "free_num": 586
14
      }
15
    ],
16
    "storey": [
17
      {
18
        "id": "10",
19
        "name": "2F",
20
        "nameMerge": "",
21
        "parentId": "1",
22
        "topId": "10",
23
        "total_num": 300,
24
        "free_num": 150
25
      }
26
    ],
27
    "area": [
28
      {
29
        "id": "100",
30
        "name": "东区阅览室",
31
        "nameMerge": "",
32
        "parentId": "10",
33
        "topId": "100",
34
        "total_num": 56,
35
        "free_num": 23
36
      }
37
    ]
38
  },
39
  "msg": "..."
40
}

字段说明：

• premises：校区级
• storey：楼层级（通过 parentId 关联到 premises[].id）
• area：区域级（通过 parentId 关联到 storey[].id），预约时使用的 roomID 即 area 的 id
• total_num / free_num：可能是字符串也可能是数字，需兼容解析

5.2 获取时间段#

根据 area ID 获取对应日期可预约的时间段。

请求体：

1
{"build_id": 100}

成功响应：

1
{
2
  "code": 1,
3
  "data": [
4
    {
5
      "day": "2026-07-05",
6
      "times": [
7
        {"id": 123456},
8
        {"id": 123457}
9
      ]
10
    }
11
  ],
12
  "msg": "..."
13
}

• 匹配 day == 目标日期 的条目，取第一个 times[0].id 作为时间段 ID（segment）。
• id 字段可能是字符串或数字。

5.3 获取座位列表#

请求体：

1
{
2
  "area": 100,
3
  "segment": 123456,
4
  "day": "2026-07-05",
5
  "startTime": "08:00",
6
  "endTime": "22:00"
7
}

成功响应：

1
{
2
  "code": 1,
3
  "data": [
4
    {
5
      "id": "13855",
6
      "no": "071",
7
      "name": "71号",
8
      "status_name": "空闲",
9
      "status": "1"
10
    },
11
    {
12
      "id": "13856",
13
      "no": "072",
14
      "name": "72号",
15
      "status_name": "已预约",
16
      "status": "2"
17
    }
18
  ],
19
  "msg": "..."
20
}

座位状态码对照：

5.4 预约座位#

最核心的接口。

请求体：

1
{"aesjson": "<AES加密后的预约数据>"}

加密前明文 JSON：

1
{"seat_id": "13855", "segment": "123456"}

• 加密方案：AES-128-CBC，Key = 当天日期(YYYYMMDD) + 反转后的当天日期，IV = ZZWBKJ_ZHIHUAWEI，PKCS7 填充后 Base64 编码。
• 将加密结果填入 aesjson 字段。

成功响应：

1
{
2
  "code": 0,
3
  "msg": "预约成功",
4
  "data": {"id": "2599221"}
5
}

data 字段兼容性： 可能是对象 {"id":"..."}、字符串 "..." 或数字，需全部兼容。

所有可能的响应情况及处理建议：

5.5 取消预约#

请求体：

1
{
2
  "id": "2599221",
3
  "authorization": "bearer<Token>"
4
}

成功响应： {"code": 1, "msg": "..."} 失败： code != 1

Token 需同时出现在 Header Authorization 和请求体 authorization 中。

5.6 查询预约列表#

查询当前用户的所有预约记录。

请求体：

1
{"authorization": "bearer<Token>"}

成功响应：

1
{
2
  "code": 1,
3
  "data": [
4
    {
5
      "id": "2599221",
6
      "areaName": "东区阅览室",
7
      "spaceName": "71号",
8
      "no": "071",
9
      "statusName": "已预约",
10
      "cancel": 0
11
    }
12
  ],
13
  "msg": "..."
14
}

• cancel：0 = 可取消，1 = 不可取消。

5.7 签到#

请求体：

1
{
2
  "aesjson": "<AES加密后的签到数据>",
3
  "authorization": "bearer<Token>"
4
}

加密前明文： {"method":"checkin"}

• 加密方案与预约一致（日期 Key + 固定 IV）。

成功响应： {"code": 1, "msg": "..."} 已签到（仍视为成功）： 响应体含 "不用重复签到" 字样

5.8 查询当前座位#

签退前查询当前用户正在使用或已预约的座位。

请求体：

1
{
2
  "page": 1,
3
  "limit": 3,
4
  "authorization": "bearer<Token>"
5
}

成功响应：

1
{
2
  "code": 1,
3
  "data": {
4
    "data": [
5
      {
6
        "id": "13855",
7
        "area": "东区阅览室",
8
        "no": "071",
9
        "statusName": "使用中"
10
      }
11
    ]
12
  },
13
  "msg": "..."
14
}

• 签退时应优先查找 statusName 含 "使用中" 的座位。
• 若没有 "使用中" 状态的座位，则无需签退。

5.9 签退#

请求体：

1
{
2
  "id": "<座位ID，来自 Member/seat 接口>",
3
  "authorization": "bearer<Token>"
4
}

成功条件（满足任一即成功）：

• code == 1
• msg 包含 "完全离开操作成功"
• msg 包含 "已经签退"