Skip to content

Appendix Sources

ChangYo edited this page Oct 26, 2026 · 3 revisions

资料来源

这页列出我们实际用来支撑结论的来源。每条写清楚它支持什么,方便复核或继续查证。

Note

这是全站唯一允许集中放链接的页面,是链接政策的明确例外;正文结论仍然要在对应平台页就近标注来源。

官方入口

来源 支持什么 链接
交大开发者平台 Open API、jAccount、数据资源、InfoPlus 总入口 打开
Open API 概述 请求/响应、分页、错误码、scope 申请 打开
Open API 接口列表 Profile/Enterprise/Education/Task/Mail/File/Notification/Finance/Card/Unicode/Barcode/Calendar/Signature 打开
jAccount OAuth 授权码、客户端凭据、密码模式、scope 表 打开
jAccount OIDC ID Token、授权码/隐式流程、登出、身份类型 打开
Profile API 字段级 scope、身份结构 打开
Education API 教学班、课表、考试/GPA「尚未实现」 打开
数据资源 API REST、exchange_data、first/offset、字段审批、错误码 打开
InfoPlus API Reference OAuth、User/System Token、App 类型、端点、数据模型 打开
交我办应用规范 应用上线、任务集成、JS SDK 打开
网络信息中心 jAccount 接口 申请对象、流程、app 网址检查 打开
交大邮箱服务 IMAP/SMTP 参数 打开
交大云盘 Pan 服务说明、jBox 下线、1TB 打开
交大 VPN 客户端与使用 打开
jCloud 控制台、文档、Token、REST 打开
交我算 HPC 账号、Slurm、存储、HPC Studio 打开
致远一号 模型、端点、配额、校园网限制 打开
Canvas(交大) 课程/文件/作业入口 打开
Canvas API(交大实例) REST 文档 打开
选课社区 课程点评入口 打开
JCourse API 参考(站点自有) 选课社区端点、字段、分页、错误码、API Key 打开
传承·交大 课程资料入口、条款、上传规范 打开
第二课堂 校园活动入口 打开
第二课堂(校内通知) 平台启用与使用说明 打开
交大视频 课堂录像入口 打开
水源社区 站点与协议 打开、打开
教学信息服务网 课表/成绩入口 打开
交我办 申请、待办、流程 打开

上游协议/规范

这些是「平台底座」,比学校页面更稳定:

来源 支持什么
OAuth 2.0(RFC 6749) 授权码、客户端凭据、refresh token、错误
OpenID Connect Core ID Token、nonce、claims、签名验证
Canvas LMS REST API 课程/作业/提交/文件/模块/讨论的字段与行为
Canvas Access Tokens 个人 Token 生命周期、权限
Discourse User API Key Specification 水源 key 的授权/加密/请求头
IMAP(RFC 3501) UID、UIDVALIDITY、FETCH、STORE、APPEND
SMTP(RFC 5321) 发信、信封、错误
MIME(RFC 2045/2046/2231) 正文、附件、中文文件名

社区项目

只列我们实际参考过的;每个都标「它证明了什么」,不把它当官方契约。

项目 证明了什么 链接
SJTU-Geek/sjtu-mcp-server i.sjtu 课表/成绩/GPA/考试、邮箱、场馆、第二课堂、教务/新闻的 MCP 工具形态 打开
xhh678876/openclaw-sjtu 校园 Agent 的覆盖面:Canvas、邮箱、食堂、图书馆、空教室、班车、校历、新闻、水源、jCourse 打开
sunalan2025/sjtu-downloader-all-in-one v.sjtu/Canvas/CNMOOC/Pan 的下载链路、LTI/JWT、Pan 私有 API、PPT 切片 打开
PhotonQuantum/pysjtu i.sjtu 课程/选课/课表/考试/GPA 的历史实现 打开
Okabe-Rintarou-0/SJTU-Canvas-Helper Canvas 桌面客户端、MCP 暴露方式 打开
dajiaohuang/shuiyuan-mcp 水源搜索/读取/用户/频道的 MCP 工具 打开
1357310795/TboxWebdav Pan 私有 API/UserToken/WebDAV 打开
SJTU-jCourse/next 选课社区站点与 API 实现、API Key 机制 打开
SJTU-Geek/sjtu-mcp-contrib 第二课堂端点、method 枚举、报名表 tag 打开
SJTU-HPC/SJTU-SLURM-Skill HPC/Slurm 的 Agent 封装 打开

内部资料

来源 支持什么
Dela/docs/sjtu-apis.md Canvas 实测原始记录;126 条公开资料索引
Dela/src/main/canvas/api.ts Canvas 端点、分页、下载、错误处理
Dela/src/main/timetable/api.ts i.sjtu 课表、学期代码、周次
Dela/src/main/vsjtu/api.ts 课堂视频课程/录像/播放流
Dela/src/main/shuiyuan/api.ts 水源授权、端点、写操作
Dela/src/main/mail/* IMAP/SMTP、同步、MIME
Dela/src/main/campus.ts 校园会话、登录窗、Cookie 持久化
Dela/docs/DEVELOPMENT.md 课堂视频、安全边界、架构约定
2026-10-26 三站实测(以只读为主,未入库) 选课社区、传承·交大、第二课堂的端点、字段与错误形态

怎么用这些来源

  1. 先看官方或上游文档:有正式契约时,优先使用官方或上游文档。
  2. 再用社区项目交叉验证:社区项目只证明有人运行成功,不代表当前仍然可用。
  3. 最后自行验证:使用本人账号、当前时间和最小请求,记录日期、权限和样本。
  4. 冲突时以实测为准:同时在页面中保留官方说法和差异,不要静默修改。
  5. 链接只挂在它支持的句子上:没有对应结论的链接,不进这页。

变更记录

  • 2026-10-25:首版。把原来的 129 条链接索引收敛成「来源 + 它支持什么」。
  • 2026-10-26:补选课社区、传承·交大、第二课堂的官方入口与社区实现。

Clone this wiki locally