[关闭]
@Humbert 2018-05-26T14:44:42.000000Z 字数 1782 阅读 944

Dora API

大学列表

URL Header Method
/api/universities/ GET

Responses Body

  1. {
  2. "universities":["CCNU", "WUST", ... ...]
  3. }

获取登录所需信息

URL Header Method
/api/universities/schema/ POST

Request Body

  1. {
  2. "university_name": "华中师范大学"
  3. }

Responses Body

  1. {
  2. "username":"str",
  3. "password":"passwrod",
  4. "verify": 1 or 0
  5. }

预获取验证码(若需要)

URL Header Method
/api/universities/pre_verify/ POST

Request Body

  1. {
  2. "university_name": "WUST"
  3. }

Response

  1. {
  2. "msg":"ok"
  3. }

获取验证码(若需要)

URL Header Method
/api/universities/verify/ POST

Request Body

  1. {
  2. "university_name": "WUST"
  3. }

Response Data
图片文件

登录

URL Header Method
/api/login/ POST

Request Body

  1. {
  2. "university_name":"string",
  3. "login_info":{
  4. "username":"xxxxx", //大学学号
  5. "password":"xxxxx", // 教务处密码
  6. "verify":"string" // 若有则填,否则为空
  7. }
  8. }

Response

  1. {
  2. "token": token
  3. }

OR

  1. {
  2. "msg":"failed" // 原有用户登录失败
  3. }

OR

  1. {
  2. "msg":"school check failed" // 未通过学校验证
  3. }

Status Code
200 原有用户登录
201 新建的用户
401 登陆失败

添加老师

URL Header Method
/api/teacher/ Authorization:token POST

Request Body

  1. {
  2. "teacher_name":string,
  3. "research_direction":string,
  4. "photo_url":string, //可省略,默认为王攀www
  5. "sex":"男" or "女",
  6. "birth": int //年份
  7. }

Response
201

  1. {
  2. "created": integer //teacher id
  3. }

401

  1. {
  2. "msg":"401 unAuthorization"
  3. }

.
403

  1. {
  2. "msg":"403 Forbidden"
  3. }

评论老师

URL Header Method
/api/teacher/<tid>/ Authorization:token POST

Request Body

  1. {
  2. "score": 15 integer,
  3. "content": string
  4. }

Response Body
Status Code:201

  1. {
  2. "msg":"success"
  3. }

Status Code:401

  1. {
  2. "msg":"401 unAuthorization"
  3. }

Status Code:403

  1. {
  2. "msg":"403 Forbidden"
  3. }

获取老师列表

URL Header Method
/api/teacher/<schoolname>/page/<page_num>/ GET

schoolname: 例如华中师范大学
page_num: 从1开始

Response Body

  1. {
  2. "allpages":integer, //总页数
  3. "teachers":[
  4. {
  5. "tid":integer,
  6. "name":string,
  7. "photo": string
  8. "direction": string
  9. "score": float
  10. }......
  11. ]
  12. }

获取有关老师评论

URL Header Method
/api/teacher/<tid>/info/page/<page_num>/ GET

tid: 老师id
page_num: 页码从1开始
Response Body

  1. "allpages": integer,
  2. "teacher":{
  3. "tid":int,
  4. "name":string,
  5. "photo":string,
  6. "direction":string,
  7. "score":float,
  8. "sex":string
  9. },
  10. "comments": [
  11. {
  12. "score":int,
  13. "content":string
  14. }, ... ...
  15. ]
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注