- Do hầu hết các command đểu trả về json,
*đánh dấu những command trả output ra màn hình. - Khi thiếu
--semester, CLI chọn kỳ cóstartDatemới nhất. Nếu ngày bị thiếu hoặc sai định dạng, bạn cần chỉ định kỳ bằng--semesterhoặc-s. - Với
week-timetable, năm được chọn theo--year, rồi năm trong--date, sau cùng là năm hiện tại.--weekưu tiên hơn việc tra số tuần từ ngày. - Dấu
+đánh dấu command có thể tự chọn kỳ. Để xem kỳ trước, bạn cần truyền--semesterhoặc-s.
myfap --help
Usage: myfap [OPTIONS] COMMAND [ARGS]...
CLI Tool dựa trên MyFAP dành cho Sinh Viên FPTU
Options:
-c, --campus <str> Mã cơ sở; dùng session, APHL chỉ mặc định cho v1
--config <str> Đường dẫn file session tùy chỉnh
--timeout SECONDS Timeout HTTP theo giây; ưu tiên hơn MYFAP_TIMEOUT
--api-version [v1|v2] Chọn v1/v2; ưu tiên option, MYFAP_API_VER, session, rồi v2
--help Show this message and exit.
Commands:
version Hiển thị phiên bản MyFap API CLI
doctor Chẩn đoán cấu hình explicit/default; không đọc hoặc làm mới session.
login Đăng nhập vào hệ thống FEID
logout Đăng xuất (Xóa session)
refresh Làm mới token (Refresh Token)
campuses Xem danh sách các cơ sở (Campus)
semesters Xem danh sách kỳ học
schedule Xem lịch học
transcript Lấy bảng điểm toàn khóa theo contract API đã chọn.
courses Lấy danh sách khóa học theo kỳ.
marks Xem bảng điểm theo kỳ, chi tiết môn hoặc tổng kết.
exams Xem lịch thi
week-timetable Xem lịch học theo tuần
attendance Xem thông tin điểm danh
applications Xem danh sách đơn từ đã gửi cho trường
news Xem tin gần nhất hoặc tìm kiếm thông báo.
info Xem thông tin chung (sinh viên, campus)
other Các chức năng phụ trợ khác (survey, feedback, fee...)
myfap semesters
Bạn có thể đặt --timeout trước hoặc sau command, kể cả khi gọi nhóm other hoặc info:
myfap --timeout 20 schedule --stdout
myfap --timeout 2.5 campuses
myfap --timeout 45 other subjects --stdout
myfap schedule --stdout --timeout 20
myfap info student --timeout 20 --stdoutĐể dùng chung cho nhiều lệnh trong PowerShell:
$env:MYFAP_TIMEOUT = "20"
myfap schedule --stdout
myfap --timeout 40 other subjects --stdout
Remove-Item Env:MYFAP_TIMEOUTThứ tự ưu tiên là --timeout → MYFAP_TIMEOUT → mặc định. Cả hai cách nhận số giây hữu hạn lớn hơn 0, gồm số thập phân. Giá trị sai trả lỗi qua stderr trước khi gọi HTTP; option hợp lệ vẫn dùng được khi biến môi trường sai.
| Request | Khi không cấu hình | Khi có option hoặc biến môi trường |
|---|---|---|
| Dữ liệu FAP và survey | 10 giây | Giá trị đã chọn |
Danh sách môn other subjects |
30 giây | Giá trị đã chọn, tối thiểu 30 giây |
| Discovery/JWKS, lấy token và handshake FEID/FAP | 10 giây | Giá trị đã chọn |
Trước đây biến môi trường chỉ áp dụng cho request dữ liệu; nay cả biến môi trường và option đều áp dụng cho HTTP ở bước xác thực. Theo cách xử lý của Requests, timeout giới hạn chờ kết nối và chờ dữ liệu giữa các lần đọc, không giới hạn tổng thời gian chạy command. Thời gian chờ đăng nhập trên trình duyệt vẫn là 120 giây.
myfap schedule -s Summer2026
myfap schedule -s Summer2026 --ics
myfap exams -s Summer2026
myfap week-timetable --week 22
myfap week-timetable --date 2026-06-07
myfap attendance -s Spring2026
myfap attendance -sc CSD201 -cn SE2026 -s Spring2026
myfap marks -s Fall2025
myfap marks -cid 95619
myfap marks -cid 95619 -p
myfap applications
myfap news
myfap info student
myfap info campus
myfap other --help
Usage: myfap other [OPTIONS] COMMAND [ARGS]...
Các chức năng phụ trợ khác (survey, feedback, fee...)
Options:
-c, --campus <str> Mã cơ sở; dùng session, APHL chỉ mặc định cho v1
--config <str> Đường dẫn file session tùy chỉnh
--timeout SECONDS Timeout HTTP theo giây; ưu tiên hơn MYFAP_TIMEOUT
--api-version [v1|v2] Chọn v1/v2; ưu tiên option, MYFAP_API_VER, session, rồi v2
--help Show this message and exit.
Commands:
training Lấy điểm phong trào theo kỳ.
survey Kiểm tra các survey chưa thực hiện
feedback Kiểm tra Feedback
feedbacks Lấy danh sách feedback student (chỉ API v2); item schema chưa kiểm chứng positive.
profile Kiểm tra Update Profile
notification Xem thông báo qua MSSV
fee Lấy danh sách học phí và trạng thái thanh toán từng khoản
balance Lấy số dư tài khoản; không diễn giải thành trạng thái nợ học phí.
subjects Lấy tất cả môn học hoặc các môn của một kỳ chỉ định.
rating Đánh giá dịch vụ; list hiện chỉ hỗ trợ API v1
myfap refresh
Bạn có thể chuyển output vào file hoặc pipe sang công cụ khác. JSON được ghi ra stdout bằng UTF-8, giữ nguyên dấu tiếng Việt kể cả khi text encoding của stdout là cp1252. ICS giữ nguyên byte và CRLF. Log và lỗi đi qua stderr; lỗi trả exit code khác 0.
Hai bảng campuses và semesters cũng xuất qua UTF-8 để giữ tên cơ sở, kỳ học có dấu khi stdout dùng cp1252. Các lệnh này vẫn hiển thị bảng, không đổi sang JSON.
Root --help, help của nhóm và lệnh con cũng giữ đầy đủ nội dung tiếng Việt khi stdout dùng cp1252. Chỉ đường xuất help được xử lý; CLI không đổi encoding toàn cục của stdout.
myfap schedule --stdout > schedule.json
myfap schedule --ics --stdout > schedule.icsother fee giữ mọi dòng server trả về, gồm IsPaid, số tiền và thông tin hóa đơn. HTTP 404 là lỗi API, không có nghĩa là tài khoản không nợ. other survey giữ nguyên body code: "404", message: "Data Not Found", data: null khi server trả HTTP 200; trạng thái này chưa xác nhận còn hay hết survey bắt buộc.
myfap login -f
Session chỉ được thay sau khi đăng nhập và handshake thành công. Xem quy tắc session và refresh trước khi dùng lại session từ phiên bản cũ.
myfap --config "%appdata%\myfap-api-cli\session.json" login