Repository navigation
Appendix Verification
ChangYo edited this page Oct 26, 2026
·
3 revisions
这页只放还没有复现、不能写成事实的线索。每条都写清楚:要验证什么、怎么验证、需要什么权限。验证完成后,把结论写进对应平台页,并从这页删掉。
Note
不要把这里的条目直接写进生产代码。它们只是「值得查」的线索,不是契约。
| 项 | 要验证什么 | 怎么验证 | 需要 |
|---|---|---|---|
| i.sjtu 成绩/考试/GPA | 端点、参数、CSRF/Referer、字段、分页 | 本人账号抓一次成绩页/考试页请求;对照 pysjtu、sjtu-mcp-server
|
本人账号、当前学期有成绩 |
课堂视频 list/termYear
|
参数、返回结构、currentTerm 是否稳定 |
学期切换前后各抓一次;对照 Dela api.ts
|
本人账号、两个学期 |
| 课堂视频转写/PPT 异步状态 | 状态字段、完成条件、重试间隔 | 录制后连续几天抓同一场次 | 本人账号、有录课课程 |
水源 POST /uploads.json
|
是否可用、大小限制、返回 short_url
|
write key 上传一张小图;看 200/413/403 | write key、测试帖 |
| 水源通知已读/发帖/私信写 | 具体端点、权限、CSRF | write key 在测试对象上逐项试;能撤销的先确认撤销 | write key、测试主题 |
| Canvas 作业提交/上传 | 端点、scope、文件字段、幂等 | 在测试课程/测试作业上试;不要提交真实作业 | 测试课程、本人 Token |
| Canvas OAuth(Developer Key) | 授权码流程、refresh、多用户 | 联系 Canvas 管理方申请 Developer Key | 管理方批准 |
| Pan 私有 API |
/api/v1 端点、UserToken 刷新、COS 分片 |
对照 sjtu-downloader-all-in-one,小文件试 |
本人账号、测试文件 |
| 数据资源 API 字段行为 | 实际返回字段、分页上限、错误码 | 有审批的应用/字段;小范围查询 | 部门应用、字段审批 |
| InfoPlus File/Notification/Export | 端点、权限、返回格式 | 有 App/流程权限的环境;测试流程 | App、租户/流程管理员 |
| 项 | 要验证什么 | 怎么验证 | 需要 |
|---|---|---|---|
| Open API Enterprise | 组织/岗位/权限/校历端点 | 有 scope 的应用;逐接口试 | clientId + scope |
| Open API Mail | 读/发/状态端点 | 有 read_mails/send_mail 的应用 |
clientId + scope |
| Open API Card/Finance/Signature | 读写边界、高风险确认 | 不要在真实账户上试写;先读文档/沙箱 | 业务审批 |
水源 message_bus
|
能否做推送式更新 | 抓 /message-bus/...;看 message_bus_last_id
|
登录会话 |
| 水源 AI 摘要 |
summarizable/has_cached_summary 对应端点 |
找有摘要的帖子;抓请求 | 登录会话 |
| 教务成绩/考试页面 | 是否仍是 cjcx/xskscx 家族 |
DevTools 抓请求;对照社区代码 | 本人账号 |
| 体育场馆 | 场地图/订单/取消端点 | 只读查询;不要自动预约 | 本人账号 |
| 第二课堂报名/取消 |
method: 7 的语义、form_value 结构、取消端点 |
在可退的测试活动上报名再取消,逐项记录 | 本人账号、测试活动 |
| 图书馆 | 借阅/座位/研讨间 | 只读查询 | 本人账号 |
| 传承·交大 下载/积分 | 下载扣分规则、积分记录端点、重复下载是否再扣 | 选一份低价资料下载一次;对照 has_purchased
|
本人账号、少量积分 |
| 传承·交大 上传 | 上传端点、文件类型/大小限制、审核状态 | 上传一个无版权测试文件 | 本人账号 |
| 选课社区写操作 | 点评、投票、关注、选课记录的端点与撤销 | 用本人 Key 发一条可删除的测试点评;逐项试 | 本人 Key、可删除的测试内容 |
| 班车/食堂/空教室 | 数据源、更新频率 | 对照 openclaw-sjtu;连续几天观察 |
公开页面/校园会话 |
| 项 | 问题 |
|---|---|
| SJTU Date | 正式入口、账号体系、可读数据 |
| 龙虾广场 | 正式入口、内容范围、与 OpenClaw 的关系 |
| CNMOOC | 课程目录、学习进度、SSO 会话 |
选课社区 /api/ext/*
|
系统 Key 的申请条件、端点与用途 |
| 校园卡/思源码 | 支付码/身份码的合规边界;默认不做 |
- 把结论写进对应平台页的端点、字段和常见问题部分。
- 标
[实测 YYYY-MM-DD,账号权限范围,样本量]。 - 如果结论是「不可用」,写进已废弃接口。
- 从这页删掉条目;在页面「变更记录」加一行。
- 至少两次独立请求,排除偶发。
- 记录 method/path/status/关键字段/日期。
- 写操作要在测试对象上做,先确认撤销路径。
- 不贴 Token/Cookie/学号/姓名/正文。
- 不接受「我这边可以」但没有请求/响应的结论。
- 2026-10-25:首版。把 Roadmap 的公开 TODO 改成可认领的验证队列。
- 2026-10-26:第二课堂、选课社区已有平台页,待验证项收缩到写操作与未覆盖端点;补传承·交大的下载、积分和上传。
本 Wiki 记录的是开发实践,不是学校官方承诺。每个结论都标注证据与日期;校园平台会调整字段、权限和登录方式,动手前请按页面里的「最后验证」复核。发现过期内容请提 Issue 或直接改。