nkust-itc/ap-api

NKUST-AP-完善計畫

ap-api's Issues

Add submit News API

獲得期中預警

GET /user/midterm-alerts
期中預警
可以跨學期取得期中預警

獲得畢業門檻狀態

'GET' /user/graduation-threshold

獲得畢業門檻狀態

獲得使用者的圖書館資料

GET /library/info

獲得圖書館證號(不一定為學號)
基本資料以及目前借閱的書籍數量

Add GitHub Url

Add GitHub Url to https://kuas.grd.idv.tw:14769/v2/

Add required to course response

required": "【必修】"

獲得使用者獎懲紀錄

GET /user/reward-and-penalty

獲得使用者獎懲紀錄

可跨學期查詢

獲得校車時間表

GET /bus/timetables

查詢該使用者指定時間的校車列表

---

(已完成)
時間表若沒有做任何更動(新預約、取消預約 等等)
會在Redis 儲存短暫時間來減少向學校查詢的次數

SECRET_KEY should not commit to remote

AP-API/src/config.py

Line 4 in 56d3716

SECRET_KEY = "sdfsdhpmrgewf"

@abc873693
Is current api server using this SECRET_KEY ?

獲得課表

GET /user/coursetable

獲得使用者課表包含修課列表

可以跨學期獲取

獲取該校區的教室列表

GET /user/room/list

獲取該校區的教室列表，以便做空閒教室查詢

Add sample API

New News API

Return all of news.

預約指定校車

PUT /bus​/reservations

預約指定校車

Fix webap URL

Update to https://webap.nkust.edu.tw/nkust/index_main.html.

登入部分

POST /oauth/token
登入 v3 API

DELETE /oauth/token
刪除單次登入token

DELETE /oauth/token/all
刪除所有已登入token

Add git url in v2 endpoints

Add git url in @api_v2.route('/') response

Support five campus login

Only remove bus system login limit.
But need to add some config block feature in app.

獲得學期成績

GET /user/scores
得到學期成績 (修課列表、期中分數、期末分數、班排等等)

可以跨學期獲取學期成績

獲得使用者請假紀錄

GET /leaves

獲得使用者請假紀錄

請假申請

POST /leaves/submit

向導師請假
需要把檔案上傳製作完成

v3 API task list

here
https://github.com/NKUST-ITC/AP-API/tree/develop/docs/v3

獲取該教室的課表(空閒教室查詢)

GET /user/empty-room/info

查詢該教室的課表內容

Add /v2/views/ap.py in test.py

獲取校務通最新消息

GET /news/announcements
GET /news/announcements/{id}
GET /news/announcements/all

後端儲存續用Sqlite，增新修改刪除後續透過API完成
文件規格須補上

獲得使用者請假所需的資訊

GET /leaves/submit/info

獲得需要向哪位老師請假，請假id的key value

Leave submit need fixed

There is a huge problem in special case on leave submit.
And need help on this.

If you are interesting on this, contact me for more information.

Redesign Icon

https://www.google.com/design/spec/style/icons.html

Remove leave login in api login

kuas 10401 schedules

[{'events': ['(9/14)日間部、進修推廣處開學'], 'week':'第一週'}, {'events': ['(9/28)補假一天(補 9/27 中秋節)'], 'week': '第三週'}, {'events': ['(10/9)補假一天(補 10/10 國慶日)'], 'week': '第四週'}, {'events': ['(10/25)校運會','(10/29)校運會補假ㄧ天','(10/30)校慶放假一天'], 'week': '第七週'}, {'events': ['(11/911/14)日間部、進修推廣處期中考試'], 'week': '第九週'}, {'events': ['(1/1)開國紀念日放假ㄧ天'], 'week': '第十六週'}, {'events': ['(1/91/15)日間部、進修推廣處期末考試'], 'week': '第十八週'}, {'events': ['(1/30)補行上班'], 'week': '第十週'}, {'events': ['(11/26) 燕巢 三合一選舉', '(11/27) 建工 三合一選舉'], 'week': '寒假'}];

獲得使用者資料

GET /user/info
獲得使用者在校務系統的資料，包含個人大頭照url

v3

獲得學期列表

GET /user/semesters

獲得所有學期列表，以及目前日期的學期

Port kuasMailCatcher to API

獲取學校最新消息

GET /news/school

獲取教務處最新消息

Add `force_update` to versions api

GET /user/graduation-threshold

畢業門檻查詢
雖然在校務系統內，但是連結為ength.kuas.edu.tw

校務系統 透過func.php 獲取 ength.kuas.edu.tw cookies

跟其餘的ap query 方法不一樣，先暫時擱置等待其他解法(或是硬A)

Schedules API

GET /user/semesters

尚未找到可以參考入學年的點

Porting all v1 api to v2

AP endpoints ?

How to design /v2/ap functions endpoints?

e.g. GET course timetable (學期課表) and GET club activate history (社團活動紀錄)

GET /v2/ap/course_timetable (課表)
GET /v2/ap/students/course_timetable (學務/課表)
GET /v2/ap/students/queries/course_timetable (學務/查詢/課表)
GET /v2/ap/queries/course_timetable (查詢/課表)
GET /v2/ap/quieries/students/course_timetable (查詢/學務/課表)

GET /v2/ap/club_history (社團活動紀錄)
GET /v2/acadimics/club_history (教務/社團活動紀錄)
GET /v2/ap/acadimics/queries/club_history (教務/查詢/社團活動紀錄)
GET /v2/ap/queries/club_history (查詢/社團活動紀錄)
GET /v2/ap/queries/academics/club_history (查詢/教務/社團活動紀錄)

取消預約指定校車

DELETE /bus/reservations

取消預約指定校車

獲得校車罰款

GET /bus/violation-records

獲得使用者校車罰款

Add bus travel API

endpoint: http://bus.kuas.edu.tw/API/travels/getOwn
data: start, page, limit

Delete non-exist bus reserve cause HTTP 500

Problem from kuas_api/kuas/bus.py function book

if kid isn't exist in unbook, then res will be undefine, thus you can't return a vaild json response.

No docstring in ap

We need some help for adding docstring in /src/views/v2/ap.py endpoints

You can see /src/views/v2/bus.py for some example

Add bus violation to API

伺服器狀態

GET /server/info

獲取學校各個伺服器&API狀態

Certbot auto renew

1. sudo iptables -I INPUT -p tcp --dport 80 -j ACCEPT
2. ./certbot-auto certonly -a webroot --webroot-path=/var/www/html -d kuas.grd.idv.tw

Docs build failed

Error Message:
ImportError: No module named flask.ext.compress

We need to change the module name in sphinx 1.5.3 (default version on readthedocs)
Use flask_compress instead.