{"id":16354592,"url":"https://github.com/jeasonstudio/ustb-teachsystem-api","last_synced_at":"2025-03-23T01:31:11.721Z","repository":{"id":133256009,"uuid":"79204615","full_name":"jeasonstudio/USTB-TeachSystem-API","owner":"jeasonstudio","description":"北京科技大学，教务管理系统接口（非官方）","archived":false,"fork":false,"pushed_at":"2017-02-11T07:55:41.000Z","size":31169,"stargazers_count":13,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-18T16:14:09.433Z","etag":null,"topics":["api","golang","ustb","ustb-teachsystem-api"],"latest_commit_sha":null,"homepage":"https://jeasonstudio.github.io/USTB-TeachSystem-API/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeasonstudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-17T08:17:18.000Z","updated_at":"2025-03-14T10:43:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"401c2c75-10a6-4525-84a9-18ff4ecccb95","html_url":"https://github.com/jeasonstudio/USTB-TeachSystem-API","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeasonstudio%2FUSTB-TeachSystem-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeasonstudio%2FUSTB-TeachSystem-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeasonstudio%2FUSTB-TeachSystem-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeasonstudio%2FUSTB-TeachSystem-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeasonstudio","download_url":"https://codeload.github.com/jeasonstudio/USTB-TeachSystem-API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245043905,"owners_count":20551848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","golang","ustb","ustb-teachsystem-api"],"created_at":"2024-10-11T01:35:51.270Z","updated_at":"2025-03-23T01:31:11.704Z","avatar_url":"https://github.com/jeasonstudio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# USTB-API\n北科大教务相关 API 接口文档\n\n - Go 语言编写\n - 项目地址：[USTB-TeachSystem-API](https://github.com/jeasonstudio/USTB-TeachSystem-API)\n - 提BUG或新API需求，请去Github仓库提issue，或发送邮件到[me@jeasonstudio.cn](mailto:me@jeasonstudio.cn)\n - HOSTPATH: http://jeasonstudio.cn:8080\n - 文档：[点我](https://jeasonstudio.github.io/USTB-TeachSystem-API/)\n - Author: Jeason\n\n目录：\n\n - [新版教务管理系统相关](README.md#L27)\n\n   - [获取所有成绩](README.md#L31)\n \n   - [获取创新学分](README.md#L90)\n \n   - [获取所有课程](README.md#L131)\n\n   - [获取考试时间地点](README.md#L227)\n\n   - [获取英语/小语种四六级成绩]()\n \n - [开发相关](README.md#L279)\n\n - [ToDoList]()\n\n\n## 1. 新版教务管理系统相关(/v1)\n\n---\n\n### 1.1 @ 获取所有成绩(/classScore.ustbsu)\n\n#### HOST: http://jeasonstudio.cn:8080/v1/classScore.ustbsu\n\n#### METHOD: GET\n\n#### 请求REQUEST:\n\n编号 | 参数名 | 值类型 | 是否必须 | 备注\n---|---|---|---|---\n1 | username | string | 是 | 学号 \n2 | password | string | 是 | 新版教务管理系统密码\n\n#### 响应RESPONSE: \n\n```json\n{\n    \"avScore\": \"99.9\",\n    \"body\": [{\n        \"className\": \"基础外语I\",\n        \"classNum\": \"10903021\",\n        \"classType\": \"人社管必\",\n        \"finalScore\": \"85\",\n        \"firstScore\": \"85\",\n        \"flag\": \"\",\n        \"learnHour\": \"64\",\n        \"semestre\": \"2015-2016-1 \",\n        \"stuScore\": \"4\"\n    }, {\n        \"className\": \"计算机算法设计\",\n        \"classNum\": \"4248002\",\n        \"classType\": \"本专业选\",\n        \"finalScore\": \"91\",\n        \"firstScore\": \"91\",\n        \"flag\": \"\",\n        \"learnHour\": \"16\",\n        \"semestre\": \"2015-2016-1 \",\n        \"stuScore\": \"1\"\n    }],\n    \"gpa\": \"5.00\"\n}\n```\n\n编号 | 参数名 | 值类型 | 备注\n---|---|---|---|---\n1 | avScore | string | 加权平均分 \n2 | gpa | string | GPA\n3 | className | string | 课程名\n4 | classNum | string | 课程号\t\n5 | classType | string | 课程类别\t\n6 | finalScore | string | 最终成绩(对外成绩单)\t\t\n7 | firstScore | string | 第一次成绩(排名用)\t\n8 | flag | string | 重修补考标志\n9 | learnHour | string | 学时\n10 | semestre | string | 学年学期\n11 | stuScore | string | 学分\n\n---\n\n### 1.2 @ 获取创新学分(/cxScore.ustbsu)\n\n#### HOST: http://jeasonstudio.cn:8080/v1/cxScore.ustbsu\n\n#### METHOD: GET\n\n#### 请求REQUEST:\n\n编号 | 参数名 | 值类型 | 是否必须 | 备注\n---|---|---|---|---\n1 | username | string | 是 | 学号 \n2 | password | string | 是 | 新版教务管理系统密码\n\n#### 响应RESPONSE: \n\n```json\n[{\n    \"cxType\": \"报告\",\n    \"insertTime\": \"\",\n    \"name\": \"APP开发与行业趋势\",\n    \"score\": \"0.2\",\n    \"semestre\": \" \"\n}, {\n    \"cxType\": \"报告\",\n    \"insertTime\": \"\",\n    \"name\": \"大数据时代与微软云计算\",\n    \"score\": \"0.2\",\n    \"semestre\": \" \"\n}]\n```\n\n编号 | 参数名 | 值类型 | 备注\n---|---|---|---|---\n1 | cxType | string | 创新学分类型\n2 | insertTime | string | 录入时间\n3 | name | string | 课程名\n4 | score | string | 学分\n5 | semestre | string | 学期学年\n\n---\n\n### 1.3 @ 获取所有课程(/course.ustbsu)\n\n#### HOST: http://jeasonstudio.cn:8080/v1/course.ustbsu\n\n#### METHOD: GET\n\n#### 请求REQUEST:\n\n编号 | 参数名 | 值类型 | 是否必须 | 备注\n---|---|---|---|---\n1 | username | string | 是 | 学号 \n2 | password | string | 是 | 新版教务管理系统密码\n3 | semestre | string | 是 | 学年学期，比如：2016-2017-2\n\n#### 响应RESPONSE: \n\n\u003e **提示：** 由于此 json 接口是原来的不知道那个老师写的，其中的一些 KEY 值为汉语拼音缩写，大家自己理解。\n\n```json\n{\n    \"selectedCourses\": [{\n        \"SKRS\": \"97\",\n        \"XS\": \"32\",\n        \"DYXF\": \"2\",\n        \"TJR\": \"41524122\",\n        \"XH\": \"41524122\",\n        \"SFQK\": null,\n        \"SJCJ\": null,\n        \"BZ\": null,\n        \"XM\": \"赵吉彤\",\n        \"JXBJ\": \"计1501\",\n        \"XB\": \"男\",\n        \"DYXS\": \"32\",\n        \"SFYXTX\": \"1\",\n        \"PTK\": [],\n        \"XF\": \"2\",\n        \"RXNJ\": \"2015\",\n        \"BXJZRQ\": \"2016-09-15\",\n        \"ID\": 17613117,\n        \"KCLBM\": \"公共选修\",\n        \"DYKCH\": \"1089096\",\n        \"SKXSB_ID\": 17984823,\n        \"KHLX\": null,\n        \"ZYFX\": \"计算机科学与技术\",\n        \"JTLB\": \"普通\",\n        \"SKSJDDSTR\": \"(周4,第6节,1-16周 逸夫楼705) \",\n        \"QZ\": 0,\n        \"SFYXCX\": \"1\",\n        \"XXK\": [],\n        \"SKSJDD\": {\n            \"66\": [\"逸夫楼705\", \"1-16周\"],\n            \"318\": [\"逸夫楼705\", \"1-16周\"],\n            \"570\": [\"逸夫楼705\", \"1-16周\"],\n            \"486\": [\"逸夫楼705\", \"1-16周\"],\n            \"24\": [\"逸夫楼705\", \"1-16周\"],\n            \"654\": [\"逸夫楼705\", \"1-16周\"],\n            \"192\": [\"逸夫楼705\", \"1-16周\"],\n            \"360\": [\"逸夫楼705\", \"1-16周\"],\n            \"444\": [\"逸夫楼705\", \"1-16周\"],\n            \"276\": [\"逸夫楼705\", \"1-16周\"],\n            \"150\": [\"逸夫楼705\", \"1-16周\"],\n            \"612\": [\"逸夫楼705\", \"1-16周\"],\n            \"108\": [\"逸夫楼705\", \"1-16周\"],\n            \"234\": [\"逸夫楼705\", \"1-16周\"],\n            \"402\": [\"逸夫楼705\", \"1-16周\"],\n            \"528\": [\"逸夫楼705\", \"1-16周\"]\n        },\n        \"DYKCM\": \"身边的法律\",\n        \"KCCJ\": null,\n        \"KXH\": \"1001\",\n        \"SFKX\": \"1\",\n        \"SSNJ\": \"2015\",\n        \"KRL\": 100,\n        \"SFXZRS\": null,\n        \"KCLB\": \"7\",\n        \"SFCX\": null,\n        \"PSCJ\": null,\n        \"XSXZ\": \"普通学生\",\n        \"SFSEF\": \"0\",\n        \"XNXQ\": \"2016-2017-1\",\n        \"JSM\": [{\n            \"JSM\": \"徐铭勋\"\n        }],\n        \"FREERS\": \"0\",\n        \"JTZT\": \"10\",\n        \"KCM\": \"身边的法律\",\n        \"ZJT_ID\": null,\n        \"TKJZRQ\": \"2016-09-19\",\n        \"KCH\": \"1089096\"\n    }],\n    \"xnxqLessonPerDay\": 6\n}\n```\n\n---\n\n### 1.4 @ 获取考试时间地点(/examTime.ustbsu)\n\n#### HOST: http://jeasonstudio.cn:8080/v1/examTime.ustbsu\n\n#### METHOD: GET\n\n#### 请求REQUEST:\n\n编号 | 参数名 | 值类型 | 是否必须 | 备注\n---|---|---|---|---\n1 | username | string | 是 | 学号 \n2 | password | string | 是 | 新版教务管理系统密码\n3 | semestre | string | 是 | 学年学期，比如：2015-2016-2\n\n#### 响应RESPONSE: \n\n```json\n[\n  {\n    \"className\": \"基础外语II\",\n    \"classNum\": \"10903022 \",\n    \"examLocation\": \"逸204\",\n    \"examTime\": \"6月20日（17周周一）  上午 8:30-10:30\",\n    \"info\": \"\"\n  },\n  {\n    \"className\": \"工业产品艺术设计及3DS MAX应用\",\n    \"classNum\": \"1049021 \",\n    \"examLocation\": \"\",\n    \"examTime\": \"  \",\n    \"info\": \"该课程考试时间地点由任课老师课上公布，本系统不发布。\"\n  }\n]\n```\n\n编号 | 参数名 | 值类型 | 备注\n---|---|---|---|---\n1 | className | string | 课程名\n2 | classNum | string | 课程号\n3 | examLocation | string | 考试地点\n4 | examTime | string | 考试时间\n5 | info | string | 备注信息\n\n\n---\n\n### 1.4 @ 获取英语/小语种四六级成绩(/cetScore.ustbsu)(已废弃！)\n\n#### HOST: http://jeasonstudio.cn:8080/v1/cetScore.ustbsu\n\n#### METHOD: GET\n\n#### 请求REQUEST:\n\n编号 | 参数名 | 值类型 | 是否必须 | 备注\n---|---|---|---|---\n1 | username | string | 是 | 学号 \n2 | password | string | 是 | 新版教务管理系统密码\n\n#### 响应RESPONSE: \n\n编号 | 参数名 | 值类型 | 备注\n---|---|---|---|---\n1 | langLevel | string |  语种级别\n2 | card | string |  准考证\n3 | listenScore | string | 听力分\n4 | ReadScore | string | 阅读\n5 | WriteScore | string | 写作\n5 | otherScore | string | 综合\n5 | allScore | string | 总成绩\n5 | date | string | 考试日期\n5 | info | string | 备注消息\n\n\n\n\n\n\n\n---\n\n## 9.9 开发相关\n\n安装依赖：\n\n```Go\ngo get github.com/astaxie/beego\ngo get github.com/PuerkitoBio/goquery\ngo get github.com/bitly/go-simplejson\n```\n\n开发调试：\n```bash\nbee run\n```\n\n打包发布：\n```bash\nbee pack -be GOOS=linux GOARCH=amd64\n```\n\n上传到服务器\n\n执行，使用 Linux 做进程守护：\n```bash\nnohup ./USTB-TeachSystem-API \u0026\n```\n\n## ToDoList\n\n - [ ] 网费缴费和余额等\n\n - [ ] 志愿工时\n\n - [ ] 校园卡充值消费余额\n\n - [ ] 选课相关","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeasonstudio%2Fustb-teachsystem-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeasonstudio%2Fustb-teachsystem-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeasonstudio%2Fustb-teachsystem-api/lists"}