login-ZJU

A light-weight server-side library helping your application login to ZJU services.

Install

npm install login-zju

Usage

import { ZJUAM,ServiceName } from 'login-zju';

const am = new ZJUAM("username", "password");
const service = new ServiceName(am); // e.g. new ZDBK(am);

// then you can literally fetch the URL and login-ZJU will handle 
// login or cookie management for you.

const res = await service.fetch("/some/api",{
    method: "GET",
}); // Just like the native fetch API

console.log(await res.text());

This is mainly used for server-side applications.

Current Implemented Services

| Title | Domain | Class name | 上次成功时间 | Note | | -------- | -------------------- | ----------- | ----------- | ---- | | 统一身份认证 | zjuam.zju.edu.cn | ZJUAM | 2026/4/14 | - | | 智云课堂 | classroom.zju.edu.cn | CLASSROOM | 2026/4/14 | - | | 本科教学管理信息服务平台 | zdbk.zju.edu.cn | ZDBK | 2026/4/14 | - | | 表单填报助手 | form.zju.edu.cn | FORM | 2025/11/14 | - | | 学在浙大（zju_web） | courses.zju.edu.cn | COURSES | 2026/4/14 | | | 校园卡二维码页面 | yqfkgl.zju.edu.cn | YQFKGL | 2025/11/26 | 用于https://yqfkgl.zju.edu.cn/_web/_customizes/ykt/index3.jsp，不排除其它path下会有其它登录流程 | | 浙大先生开放平台 | open.zju.edu.cn | OPEN | 2025/11/26 | 其实就是HiAgent | | CC98 | cc98.org | CC98 | 2025/12/6 | 传参为账号密码 | | ETA 三全育人平台 | eta.zju.edu.cn | ETA | 2025/12/24 | 不会自动处理加解密，可以使用eta.encode和eta.decode | | 图书馆移动端 | api/m.lib.zju.edu.cn | APILIB | 2026/4/14 | 有一部分API需要用到bor_id，该信息可以通过apiLib.bor_id获取 | | 预约图书馆座位系统 | booking.lib.zju.edu.cn | BOOKINGLIB | 2026/4/14 | 请求body中不需要带上authorization字段，所以token设置成了private的 | | 教在浙大 | alt.zju.edu.cn | ALT | 2026/4/14 | 它有一个签名header，但是实际后端不检验 |

鉴于部分服务可能会变更登录流程，如果发现登录流程炸了，可以提交一个issue或者发布一个PR。

Login to ZJU

import { ZJUAM } from 'login-zju';

const me = new ZJUAM("username", "password");

me.fetch("https://zjuam.zju.edu.cn/path")

Login to other services

If the service is implemented:

import { ZJUAM, ZDBK } from 'login-zju';

const am = new ZJUAM("username", "password");
const ZDBK = new ZDBK(am);

ZDBK.fetch("/some/api")

If not implemented:

import { ZJUAM } from 'login-zju';

const am = new ZJUAM("username", "password");

const callbackURL = await am.service("service_url")

// fetch(callbackURL) and you can get logged in. You may need to implement further cookie handler yourself.