Home

上海交大校园服务开发 Wiki

这里整理 Dela 接入交大校园服务时验证过的接口、字段和实现经验。你可以参考这些记录，开发自己的课程工具、课表工具、邮箱客户端、水源阅读器或校园 Agent。

Important

本 Wiki 并非学校官方文档，请以最新接口说明为准。

适用场景

你想做的事	从这里开始
下载课件、整理作业 DDL	Canvas → 课程资料下载器
查课程评价、比较给分	选课社区
找往年课件、资料	传承·交大
做课表、日历、上课提醒	教学信息服务网 → 课表与 DDL 日历
查看或下载课堂录像	课堂视频
看讲座、找校园活动	第二课堂
阅读水源、检索课程信息	水源社区
做邮件客户端或未读提醒	交大邮箱
在本地工具中接入大模型	致远一号
开发实验室或社团的正式应用	Open API、InfoPlus
做部门或单位的数据交换	数据资源 API
同步云盘、使用 HPC 或云主机	交大云盘、计算与网络
聚合新闻、教务通知	校园公开信息
先确认能取得哪些数据	接口生态地图

数据源全景

数据	平台	认证	个人可得性	稳定性	手册
课程、课件、作业、提交、讨论	Canvas	个人 Access Token	高，几分钟	高	Canvas
课程评价、给分、选课记录	选课社区	用户 API Key	高，注册即用	中	选课社区
往年课件、资料	传承·交大	站点令牌（Auth）	高，需 jAccount	低	传承·交大
校园活动、讲座、报名状态	第二课堂	站点令牌（Bearer）	高，需 jAccount	低	第二课堂
课表、学期；成绩和考试仅有线索	教学信息服务网	校园会话 Cookie	高，需人工登录	低	教学信息服务网
课堂录像、转写、PPT、AI 总结	课堂视频	校园会话 Cookie	高，需人工登录	低	课堂视频
论坛主题、搜索、私信、通知	水源社区	User API Key（需站点许可）	高，但需书面许可	中	水源社区
邮件收发、附件、文件夹	交大邮箱	邮箱密码	高	高	交大邮箱
大模型推理	致远一号	API Key	高，需申请	中	致远一号
身份、组织、教学、校园卡、财务	Open API	OAuth 2.0 + scope	低，单位或教职工申请	高	Open API
流程、待办、表单、附件	InfoPlus	User/System Token	低，应用审批	高	InfoPlus
校级账号、教职工、本科教学、论文、资产	数据资源 API	Client Credentials + 字段审批	极低，部门业务	高	数据资源 API
云盘文件、同步、分享	交大云盘	jAccount / UserToken	中，无公开 API	低	交大云盘
云主机、HPC、Slurm	jCloud / 交我算	账号、SSH、项目 Token	中，需申请	高	计算与网络
新闻、教务通知、图书馆、班车、食堂、场馆	多个站点	混合	高	低	校园公开信息

「个人可得性」表示普通学生按公开流程能否取得，不代表学校批准。「稳定性」表示接口契约是否容易变化。

四条阅读路径

路线 A：先做一个最小可用工具（推荐）

1. 在 Canvas 取得 Token，读取课程和文件。
2. 参考 课程资料下载器 写第一版。
3. 遇到分页、302 或限流问题，查阅 分页、限流与错误。

路线 B：做课表、DDL 和提醒

1. 通过 教学信息服务网 登录并读取课表。
2. 在 Canvas 读取作业 due_at。
3. 参考 课表与 DDL 日历 生成日历。

路线 C：做实验室或社团的正式应用

1. 先读 接口生态地图，确认数据在哪一层。
2. 读 jAccount 与校园会话，了解申请条件。
3. 再进入 Open API、InfoPlus 或 数据资源 API。

路线 D：做选课参考或活动聚合

1. 在 选课社区 取课程评分与点评；列表里的评分分布恒为 0，要取详情。
2. 需要往年资料时，用 传承·交大 按课程查班级和资料；下载前确认积分。
3. 活动信息走 第二课堂；只读列表，报名留给用户手动完成。

阅读约定

• [官方] 学校或上游平台的公开文档；[实测] 我们实际运行过；[社区] 公开项目验证过，但不是我们运行；[待验证] 只有线索，不写成事实。完整定义见阅读约定与证据等级。
• 日期统一使用 YYYY-MM-DD，时间默认 Asia/Shanghai。所有「最后验证」只表示当天观察到的行为，不代表长期承诺。
• 代码以 TypeScript/Node 和 curl 为主，Python 只在关键处给出片段。示例不包含真实 Token、Cookie、学号或姓名。
• 每页围绕四件事组织：能取得什么、怎么取得、常见故障、限制。

最近验证

• 2026-10-26：新增选课社区、传承·交大、第二课堂三份接口实测；三站的登录态判断、列表结构和写操作边界分别记录。见 选课社区、传承·交大、第二课堂。
• 2026-10-06：课堂视频补充验证转写、AI 总结、PPT 与双路 MP4；课堂录像只需要校园 Cookie，不需要 JWT 或 LTI。见 课堂视频。
• 2026-09-21：水源楼层点赞可用，取消点赞返回 403，discourse-reactions 插件不存在。见 水源社区。
• 2026-09-15：Canvas 个人 Token 覆盖 5 个学期、48 门课程；分页上限为 50，401 有两种含义，S3 签名有效期为 1 小时。见 Canvas。

参与

页面契约、证据要求和发布流程见 贡献指南。如果接口发生变化，请提供请求、响应、日期和账号权限范围。不要贴 Token、Cookie 和个人数据。

---

最后复核：2026-10-26。