CSUSTKit 是目前特性最全、覆盖面最广的长沙理工大学校园服务 API 库。本项目旨在为开发者提供一套统一的 Swift 接口,以轻松访问学校的各类业务系统。
无论是构建学生辅助工具、校园生活应用,还是进行相关的数据分析研究,CSUSTKit 都能提供强大的底层支持。
CSUSTKit 目前集成了统一身份认证、教务系统、网络教学平台、超星学习通、大学物理实验平台与校园卡六套业务系统,提供统一登录与跨系统免登录、课表 / 成绩 / 考试 / 空闲教室查询、作业与测验进度查询、宿舍电量查询等能力。
Tip
针对偶发的校园网内网访问限制问题,CSUSTKit 提供了完善的 WebVPN 支持:
- WebVPN访问: 即使在非校园网环境下,也可以通过 WebVPN (
vpn.csust.edu.cn) 代理访问仅限内网开放的系统(如教务系统)。 - 自动处理: 库内部自动处理 WebVPN 的 URL 加密与解密逻辑,开发者无需关心复杂的协议细节,即可实现内网服务的无缝访问。
通过Package.swift添加依赖:
dependencies: [
.package(url: "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/zHElEARN/CSUSTKit.git", from: "1.0.0")
]通过Xcode添加依赖:
- 打开你的Xcode项目
- 选择File -> Add Packages Dependencies...
- 在搜索框中输入
https://github.com/zHElEARN/CSUSTKit.git - 选择
CSUSTKit并点击Add Package
完整的 API 文档:
示例代码:
该示例目录包含了从环境配置、SSO 登录、子系统访问到 WebVPN 工具使用的完整流程演示,程序入口为 AppMain.swift,各子系统演示位于 Demos/。
本项目采用 MIT License。
这意味着:
- 您可以自由地商业化使用、复制、修改和分发本项目的源代码及其副本。
- 您只需在分发时保留原作者的版权声明和许可声明即可。
- 您可以将本项目代码集成到您的闭源或商业项目中,且无需公开您自己的源代码。
- 作者不对使用本项目产生的任何后果承担法律责任。
详见 LICENSE 文件。
欢迎并鼓励大家为 CSUSTKit 做出贡献,您可以 Fork 项目,进行修改并提交 Pull Request。
如果您在使用过程中遇到问题,或对 CSUSTKit 有任何建议,也欢迎提交 Issue 来告知我们!
免责声明: 本项目仅供学习与技术研究使用,请勿用于任何非法用途。在使用过程中请遵守学校相关网络安全规定。