用Requests + Flask + Flask-restful实现的广州大学部分网站第三方API
- 更新时间: 2018.02.23
- 返回数据格式: JSON
- 练手项目 不保证效率
- 样例: 0X2A API
- 此项目仅供学习 一切后果使用者负责
pip freeze > requirements.txt安装该项目所需依赖
python app.py运行程序
- 功能
从正方系统查询个人信息 - 接口地址
/jw/info - 请求方式
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}- 请求结果示例
{
"data": {
"birthsday": "生日",
"classname": "班级",
"college": "学院",
"enterSchoolTime": "入学时间",
"gradeClass": "级",
"highschool": "高中",
"hometown": "户籍地址",
"idCardNumber": "身份证号码",
"major": "专业",
"name": "姓名",
"nationality": "民族",
"politicsStatus": "政治面貌",
"sex": "性别",
"studentnumber": "学号",
},
"status": 200
}接口可查询学期成绩、学年成绩、在校成绩。
-
功能
从正方系统直接查询当前学期成绩 -
接口地址
/jw/grade/term -
请求方式
POST -
POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}- 请求结果示例
{
"data":
{
"credit": "1.0",
"grade": "94",
"gradePonit": "4.4",
"name": "专业导论",
"term": "1",
"type": "学科基础课程",
"year": "2017-2018"
},
"status": 200
}- 接口地址
/jw/grade/year - 请求方式
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
} - 请求结果示例
{
"data":
{
"credit": "1.0",
"grade": "94",
"gradePonit": "4.4",
"name": "专业导论",
"term": "1",
"type": "学科基础课程",
"year": "2017-2018"
},
"status": 200
}- 接口地址
/jw/grade/all - 请求方式
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}- 请求结果示例
{
"data":
{
"credit": "1.0",
"grade": "94",
"gradePonit": "4.4",
"name": "专业导论",
"term": "1",
"type": "学科基础课程",
"year": "2017-2018"
},
"status": 200
}接口可查询当日图书馆进馆总人数以及各学院人数、制定日期进馆总人数以及学院人数。
- 接口地址：
/lib/num/now/total - 请求方式
GET - 请求结果示例：
{
"data": {
"TotalNum": "114"
},
"status": 200
}- 接口地址：
/lib/num/now/all - 请求方式
GET - 请求结果示例：
{
"data": {
"FacultyNum": {
"人文学院": "13",
"信息与机电工程学院": "2",
"公共事业管理（高水平运动员）": "6",
"动画": "2",
"化学化工学院": "5",
"国际教育学院": "8",
"土木工程学院": "9",
"外国语学院": "2",
"学前教育": "1",
"建筑学(景观建筑)": "4",
"数学与信息科学学院": "1",
"新闻与传播学院": "1",
"机械与电气工程学院": "10",
"法学院": "8",
"生物技术": "2",
"社会体育指导与管理": "4",
"经济与统计学院": "2",
"自然地理与资源环境": "4",
"计算机科学与教育软件学院": "3"
},
"TotalNum": "114"
},
"status": 200
}注意：只有2016.12后的数据
- 接口地址：
/lib/num/date/total - 请求方式
POST - POST请求实例
{
"begin" : "2018-1-3",
"password" : "2018-1-03",
}- 请求结果示例：
{
"data": {
"TotalNum": "5492"
},
"status": 200
}同理 想获得指定日期的各学院进馆人数只需要把接口地址的total改为all即可
接口可获得当前所借书的借出日期、归还日期，以及提供一次性续借接口并返回续借状态
- 接口地址：
/lib/books/borrowed - 请求方式：
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}```
- 请求结果示例
``` json
{
"data": {
"数据科学入门": {
"LoanDate": "20171226",
"RenewTimes": "1",
"ReturnDate": "20180418"
},
"集体智慧编程": {
"LoanDate": "20171129",
"RenewTimes": "1",
"ReturnDate": "20180319"
}
},
"status": 200
}- 接口地址：
/lib/books/borrowed - 请求方式：
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}- 请求结果示例
{
"data": {
"数据科学入门": {
"LoanDate": "20171226",
"RenewTimes": "1",
"ReturnDate": "20180418"
},
"集体智慧编程": {
"LoanDate": "20171129",
"RenewTimes": "1",
"ReturnDate": "20180319"
}
},
"status": 200
}- 接口地址：
/lib/books/renew - 请求方式：
POST - POST请求示例
{
"username" : "17xxxxxxx",
"password" : "123456"
}
- 请求结果示例
{
"data": {
"数据科学入门": "This book can not be renewed!",
"集体智慧编程": "This book can not be renewed!"
},
"status": 200
}例子中的书籍因都续借过所以无法续借。
该API内置了简单的错误处理
当你输入的username或password是错误时，会返回下面的信息：
{"message": "You give a wrong password"}当发生未知错误时，会返回下面信息：（目前没有很好地支持）
{"message": "Unknown Erorr. Try again later"}当学校服务器宕机时，可能会返回：
{"message": "Timeout!"}这一部分是以后（如果有的话）重点发展部分。
- 加入Token支持 使得不用每次都要模拟登录
- 添加课程表查询功能
- 添加一卡通功能
- 选课支持
- 想要的功能可以点个star提个issue（不存在的
待更新