💡这是一个非官方关于广州大学通用接口的仓库，制作了一个有效的通用接口，意想于提供一个“开放平台”API，供学校各个校园业务开发者提供便利。其中包括但不限于整合正方教务的一系列复杂接口，以及学生账户相关信息接口。显然，这并不排除过程中没有考虑到高并发和服务器负载的问题，甚至代码本身的异常处理也并非完善，甚至所谓“接口”的程序语言python并没有优势，因此这也只是一个简单的尝试，也希望更多优秀的校园开发者将优秀的插件与业务对接起来，丰富用户生态。
本项目旨在让校园业务开发者能够有一个便携规范的调用接口
🌏 项目的总体架构为 Python Flask Redis，
-
Flask用于接收http请求以及返回
-
Redis作为缓存，对token进行缓存
后续可能会考虑添加上nginx承载一些服务端的问题
├── index.py //web后台入口
└── utils //
├── __init__.py //主体程序初始化
├── main.py // 获取信息代码实现
├── rsa.js // rsa前台数据包解密
└── rsa.py // 打包rsa.js
当前，程序提供了三种接口方式，相关源码部署在了伺服器当中 （阿里云学生机) ，显然不能高并发的请求，但是为了接口测试，提供了api的IP网址接口。当然，API更推荐直接部署在自己的服务器当中。
与此同时，因为代码相当于一个桥梁（教务系统与第三方Client客户端）,在鉴权方面可能会出现session或者cookie连接的问题，因此可能会出现储存在服务器的cookie失效，但是在缓存当中的token仍然能使用，因此在接口调用中出现无法加载信息的情况需要重新鉴权。
我们已经将代码部署在了自己的服务器当中，请求的URL为
http://120.24.5.39:8080/v1/<method>
开放的相关接口可以通过 Postman 或 Gitbook 查看，并且请依据文档进行调用。
auth进行鉴权，取得token之后将其添加到header后发起请求。
请参考部署，将程序部署上服务器，端口默认为8080，由于linux系统特殊，进程在推出命令行的时候就会退出因此需要守护此进程。
- 使用进程守护方式运行
nohup python index.py >> index.log 2>&1 &-
退出进程
- 查看现行进程
ps -x
- 关闭进程
kill <uid>
部署在服务器上将使得更好地维护，请开放
8080端口，并依据接口文档进行调用。另外，URL需要修改为对应服务器的地址。
如果有需要二次开发，可以将程序作为库进行引入
from utils import AccountAccount类包含所需要的查询鉴权方法
eg:
_username = "2106****"
_password = "090909"
account = Account(_username, _password)
account.auth() # 鉴权
info = account.get_stu_info() # 获取信息- 克隆本仓库
git clone [email protected]:favorhau/GZHU_API.git
- 安装环境依赖
默认已经安装好python（或conda）环境，与此同时需要Flask、requests、redis等pypi库
pip install flask redis execjs requests
# pip3 install flask redis execjs requests- redis安装
- 在Linux下，可以执行
$ sudo apt update
$ sudo apt install redis-server并启动服务
$ sudo service redis start- 在Mac下安装大同小异，可通过brew进行安装
- 启动服务
python index.py
"""
* Serving Flask app "index" (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://0.0.0.0:8080/ (Press CTRL C to quit)
"""- 连接断开无请求 或 超时
由于现在的校园网验证采用HTTPS方式，因此在模拟请求的过程中可能会出现链接超时等的情况，这样需要重复请求auth鉴权。
//连接关闭
{
"data": {},
"msg": "Catch exception: ('Connection aborted.', RemoteDisconnected('Remote end closed connection without response'))"
}//连接超时
{
"data": {},
"msg": "Catch exception: HTTPSConnectionPool(host='newmy.gzhu.edu.cn', port=443): Read timed out. (read timeout=15)"
}尚未获取官方授权，正在进行可用性测试中。
仅提供简单的模拟请求服务，原则上不对任何个人信息进行储存，若有违相关规定或信息变更，烦请联系 [email protected]