https://github.com/jeasonstudio/ustb-teachsystem-api

北京科技大学，教务管理系统接口（非官方）
https://github.com/jeasonstudio/ustb-teachsystem-api

api golang ustb ustb-teachsystem-api

Last synced: 7 months ago
JSON representation

北京科技大学，教务管理系统接口（非官方）

Host: GitHub
URL: https://github.com/jeasonstudio/ustb-teachsystem-api
Owner: jeasonstudio
License: mit
Created: 2017-01-17T08:17:18.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2017-02-11T07:55:41.000Z (over 8 years ago)
Last Synced: 2025-03-18T16:14:09.433Z (7 months ago)
Topics: api, golang, ustb, ustb-teachsystem-api
Language: Go
Homepage: https://jeasonstudio.github.io/USTB-TeachSystem-API/
Size: 29.7 MB
Stars: 13
Watchers: 2
Forks: 2
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          
# USTB-API

北科大教务相关 API 接口文档

 - Go 语言编写

 - 项目地址：[USTB-TeachSystem-API](https://github.com/jeasonstudio/USTB-TeachSystem-API)

 - 提BUG或新API需求，请去Github仓库提issue，或发送邮件到[me@jeasonstudio.cn](mailto:me@jeasonstudio.cn)

 - HOSTPATH: http://jeasonstudio.cn:8080

 - 文档：[点我](https://jeasonstudio.github.io/USTB-TeachSystem-API/)

 - Author: Jeason

目录：

 - [新版教务管理系统相关](README.md#L27)

   - [获取所有成绩](README.md#L31)

 

   - [获取创新学分](README.md#L90)

 

   - [获取所有课程](README.md#L131)

   - [获取考试时间地点](README.md#L227)

   - [获取英语/小语种四六级成绩]()

 

 - [开发相关](README.md#L279)

 - [ToDoList]()

## 1. 新版教务管理系统相关(/v1)

---

### 1.1 @ 获取所有成绩(/classScore.ustbsu)

#### HOST: http://jeasonstudio.cn:8080/v1/classScore.ustbsu

#### METHOD: GET

#### 请求REQUEST:

编号 | 参数名 | 值类型 | 是否必须 | 备注

---|---|---|---|---

1 | username | string | 是 | 学号 

2 | password | string | 是 | 新版教务管理系统密码

#### 响应RESPONSE: 

```json

{

    "avScore": "99.9",

    "body": [{

        "className": "基础外语I",

        "classNum": "10903021",

        "classType": "人社管必",

        "finalScore": "85",

        "firstScore": "85",

        "flag": "",

        "learnHour": "64",

        "semestre": "2015-2016-1 ",

        "stuScore": "4"

    }, {

        "className": "计算机算法设计",

        "classNum": "4248002",

        "classType": "本专业选",

        "finalScore": "91",

        "firstScore": "91",

        "flag": "",

        "learnHour": "16",

        "semestre": "2015-2016-1 ",

        "stuScore": "1"

    }],

    "gpa": "5.00"

}

```

编号 | 参数名 | 值类型 | 备注

---|---|---|---|---

1 | avScore | string | 加权平均分 

2 | gpa | string | GPA

3 | className | string | 课程名

4 | classNum | string | 课程号	

5 | classType | string | 课程类别	

6 | finalScore | string | 最终成绩(对外成绩单)		

7 | firstScore | string | 第一次成绩(排名用)	

8 | flag | string | 重修补考标志

9 | learnHour | string | 学时

10 | semestre | string | 学年学期

11 | stuScore | string | 学分

---

### 1.2 @ 获取创新学分(/cxScore.ustbsu)

#### HOST: http://jeasonstudio.cn:8080/v1/cxScore.ustbsu

#### METHOD: GET

#### 请求REQUEST:

编号 | 参数名 | 值类型 | 是否必须 | 备注

---|---|---|---|---

1 | username | string | 是 | 学号 

2 | password | string | 是 | 新版教务管理系统密码

#### 响应RESPONSE: 

```json

[{

    "cxType": "报告",

    "insertTime": "",

    "name": "APP开发与行业趋势",

    "score": "0.2",

    "semestre": " "

}, {

    "cxType": "报告",

    "insertTime": "",

    "name": "大数据时代与微软云计算",

    "score": "0.2",

    "semestre": " "

}]

```

编号 | 参数名 | 值类型 | 备注

---|---|---|---|---

1 | cxType | string | 创新学分类型

2 | insertTime | string | 录入时间

3 | name | string | 课程名

4 | score | string | 学分

5 | semestre | string | 学期学年

---

### 1.3 @ 获取所有课程(/course.ustbsu)

#### HOST: http://jeasonstudio.cn:8080/v1/course.ustbsu

#### METHOD: GET

#### 请求REQUEST:

编号 | 参数名 | 值类型 | 是否必须 | 备注

---|---|---|---|---

1 | username | string | 是 | 学号 

2 | password | string | 是 | 新版教务管理系统密码

3 | semestre | string | 是 | 学年学期，比如：2016-2017-2

#### 响应RESPONSE: 

> **提示：** 由于此 json 接口是原来的不知道那个老师写的，其中的一些 KEY 值为汉语拼音缩写，大家自己理解。

```json

{

    "selectedCourses": [{

        "SKRS": "97",

        "XS": "32",

        "DYXF": "2",

        "TJR": "41524122",

        "XH": "41524122",

        "SFQK": null,

        "SJCJ": null,

        "BZ": null,

        "XM": "赵吉彤",

        "JXBJ": "计1501",

        "XB": "男",

        "DYXS": "32",

        "SFYXTX": "1",

        "PTK": [],

        "XF": "2",

        "RXNJ": "2015",

        "BXJZRQ": "2016-09-15",

        "ID": 17613117,

        "KCLBM": "公共选修",

        "DYKCH": "1089096",

        "SKXSB_ID": 17984823,

        "KHLX": null,

        "ZYFX": "计算机科学与技术",

        "JTLB": "普通",

        "SKSJDDSTR": "(周4,第6节,1-16周 逸夫楼705) ",

        "QZ": 0,

        "SFYXCX": "1",

        "XXK": [],

        "SKSJDD": {

            "66": ["逸夫楼705", "1-16周"],

            "318": ["逸夫楼705", "1-16周"],

            "570": ["逸夫楼705", "1-16周"],

            "486": ["逸夫楼705", "1-16周"],

            "24": ["逸夫楼705", "1-16周"],

            "654": ["逸夫楼705", "1-16周"],

            "192": ["逸夫楼705", "1-16周"],

            "360": ["逸夫楼705", "1-16周"],

            "444": ["逸夫楼705", "1-16周"],

            "276": ["逸夫楼705", "1-16周"],

            "150": ["逸夫楼705", "1-16周"],

            "612": ["逸夫楼705", "1-16周"],

            "108": ["逸夫楼705", "1-16周"],

            "234": ["逸夫楼705", "1-16周"],

            "402": ["逸夫楼705", "1-16周"],

            "528": ["逸夫楼705", "1-16周"]

        },

        "DYKCM": "身边的法律",

        "KCCJ": null,

        "KXH": "1001",

        "SFKX": "1",

        "SSNJ": "2015",

        "KRL": 100,

        "SFXZRS": null,

        "KCLB": "7",

        "SFCX": null,

        "PSCJ": null,

        "XSXZ": "普通学生",

        "SFSEF": "0",

        "XNXQ": "2016-2017-1",

        "JSM": [{

            "JSM": "徐铭勋"

        }],

        "FREERS": "0",

        "JTZT": "10",

        "KCM": "身边的法律",

        "ZJT_ID": null,

        "TKJZRQ": "2016-09-19",

        "KCH": "1089096"

    }],

    "xnxqLessonPerDay": 6

}

```

---

### 1.4 @ 获取考试时间地点(/examTime.ustbsu)

#### HOST: http://jeasonstudio.cn:8080/v1/examTime.ustbsu

#### METHOD: GET

#### 请求REQUEST:

编号 | 参数名 | 值类型 | 是否必须 | 备注

---|---|---|---|---

1 | username | string | 是 | 学号 

2 | password | string | 是 | 新版教务管理系统密码

3 | semestre | string | 是 | 学年学期，比如：2015-2016-2

#### 响应RESPONSE: 

```json

[

  {

    "className": "基础外语II",

    "classNum": "10903022 ",

    "examLocation": "逸204",

    "examTime": "6月20日（17周周一）  上午 8:30-10:30",

    "info": ""

  },

  {

    "className": "工业产品艺术设计及3DS MAX应用",

    "classNum": "1049021 ",

    "examLocation": "",

    "examTime": "  ",

    "info": "该课程考试时间地点由任课老师课上公布，本系统不发布。"

  }

]

```

编号 | 参数名 | 值类型 | 备注

---|---|---|---|---

1 | className | string | 课程名

2 | classNum | string | 课程号

3 | examLocation | string | 考试地点

4 | examTime | string | 考试时间

5 | info | string | 备注信息

---

### 1.4 @ 获取英语/小语种四六级成绩(/cetScore.ustbsu)(已废弃！)

#### HOST: http://jeasonstudio.cn:8080/v1/cetScore.ustbsu

#### METHOD: GET

#### 请求REQUEST:

编号 | 参数名 | 值类型 | 是否必须 | 备注

---|---|---|---|---

1 | username | string | 是 | 学号 

2 | password | string | 是 | 新版教务管理系统密码

#### 响应RESPONSE: 

编号 | 参数名 | 值类型 | 备注

---|---|---|---|---

1 | langLevel | string |  语种级别

2 | card | string |  准考证

3 | listenScore | string | 听力分

4 | ReadScore | string | 阅读

5 | WriteScore | string | 写作

5 | otherScore | string | 综合

5 | allScore | string | 总成绩

5 | date | string | 考试日期

5 | info | string | 备注消息

---

## 9.9 开发相关

安装依赖：

```Go

go get github.com/astaxie/beego

go get github.com/PuerkitoBio/goquery

go get github.com/bitly/go-simplejson

```

开发调试：

```bash

bee run

```

打包发布：

```bash

bee pack -be GOOS=linux GOARCH=amd64

```

上传到服务器

执行，使用 Linux 做进程守护：

```bash

nohup ./USTB-TeachSystem-API &

```

## ToDoList

 - [ ] 网费缴费和余额等

 - [ ] 志愿工时

 - [ ] 校园卡充值消费余额

 - [ ] 选课相关

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/jeasonstudio/ustb-teachsystem-api

Awesome Lists containing this project

README