全誼校務系統非官方 API

緣起

由於全誼校務系統目前沒有提供可用的 API 可以用來撈取教師與學生的帳號等資訊，本專案提供了基本的 API 供程式開發者介接與擷取全誼校務系統的教師與學生帳號資訊。

功能

本專案提供以下功能：

匯出學生資料
匯出教師資料與職務
新增/刪除教師帳號
重設教師帳號密碼

安裝

外部套件

本專案依靠 tesseract 處理圖形 captcha，因此需要安裝相關套件：

sudo apt install tesseract-ocr -y

Python 套件

本專案只在 Python 3.5+ 版本上測試過，建議使用 Python 3.5+ 以上版本運行。安裝建議使用 venv 標準函式庫建立虛擬環境安裝套件，在 Debian Stretch 中必須執行：

sudo apt install python3-venv -y

才能使用 venv 標準函式庫建立虛擬環境：

mkdir -p ~/venv
python3 -m venv ~/venv/schoolsoftapi
source ~/venv/schoolsoftapi/bin/activate
pip install schoolsoftapi

快速上手

from schoolsoftapi import SchoolSoftAPI
# 傳入的 1061 代表 106 學年度第 1 學期
api = SchoolSoftAPI('校務系統帳號', '校務系統密碼', '1061')
# 若 captcha 辨識失敗導致無法登入，等待 5 秒重試
api.login(wait=5)
# 傾印學生資料
api.dump_students()
# 傾印教師資料含職務
api.dump_teachers()
# 新增教師帳號
api.add_teacher('教師身份證字號', '教師姓名', 1, datetime.now())
# 重設教師密碼
api.reset_teacher_password('教師身份證字號', '教師姓名')
# 刪除教師教師帳號
api.delete_teacher('教師身份證字號', '教師姓名', 1, datetime.now())

專案網址

本專案程式碼託管在 https://github.com/fossnio/schoolsoftapi ，patches welcome!

開發團隊

FOSS Ninja <contact@fossn.io>

AlexW867 / schoolsoftapi