Quick start

At a glance

Three steps: install, call student verification (from a server only), and call login-free school data. Plain Java without Spring is at the bottom.

1. Install it. Pin the exact version. All versions are on GitHub Releases (API stability).

   Java

   

   Published to Maven Central, so no extra repository is needed. Java 17+, Spring Boot 3.x.

   dependencies {
       implementation "kr.suhsaechan:sejongpeia:<version>"
   }

   <dependency>
       <groupId>kr.suhsaechan</groupId>
       <artifactId>sejongpeia</artifactId>
       <version><!-- the version you pin --></version>
   </dependency>

   Put the latest version in <version>. Check it on the Maven Central artifact page; all versions are listed in the repository index.

   Python

   Python 3.9+, no dependencies beyond the standard library.

   pip install pro-sejongpeia==<version>

   Node.js

   Node 18+, zero dependencies, TypeScript types included, ESM and CommonJS.

   npm install pro-sejongpeia@<version>

2. Call student verification. One integrated call with a student ID and password.

   Java

   Spring Boot auto-configuration registers a SuhSejongAuthEngine bean.

   @RestController
   @RequiredArgsConstructor
   public class AuthController {
   
       private final SuhSejongAuthEngine sejongAuthEngine;
   
       @PostMapping("/auth/sejong")
       public SejongAuthResult authenticate(@RequestParam String studentId,
                                            @RequestParam String password) {
           return sejongAuthEngine.authenticate(studentId, password);
       }
   }

   Python

   from sejongpeia import authenticate, SejongAuthError, ErrorCode
   
   try:
       result = authenticate("21011234", "password")
       print(result.name, result.major, result.grade)
   except SejongAuthError as error:
       if error.code == ErrorCode.AUTHENTICATION_FAILED:
           print("Wrong student ID or password")
       elif error.code == ErrorCode.ACCOUNT_LOCKED:
           print("The portal account is locked. Reset the password on the portal")

   Node.js

   import { authenticate, SejongAuthError, ErrorCode } from 'pro-sejongpeia';
   
   try {
     const result = await authenticate('21011234', 'password');
     console.log(result.name, result.major, result.grade);
   } catch (error) {
     if (error instanceof SejongAuthError && error.code === ErrorCode.AUTHENTICATION_FAILED) {
       console.log('Wrong student ID or password');
     } else if (error instanceof SejongAuthError && error.code === ErrorCode.ACCOUNT_LOCKED) {
       console.log('The portal account is locked. Reset the password on the portal');
     }
   }

   Branch on the error code, never on the message. The code list is in Error codes.

3. Call school data that needs no login. Get the department list, then the course listings of the first department (undergraduate). "20" (undergraduate) and the semester value are the school’s own values.

   Java

   SejongPublicData publicData = new SejongPublicData();   // inject it as a bean in Spring
   List<Department> departments = publicData.departments("20", "2026", "20");
   List<Lecture> lectures = publicData.lectures("20", "2026", "20", departments.get(0).getCode(), "", "");

   Python

   from sejongpeia import SejongPublicData
   
   public_data = SejongPublicData()
   departments = public_data.departments("20", "2026", "20")          # undergraduate
   lectures = public_data.lectures("20", "2026", "20", department_code=departments[0].code)
   # Course number of a lecture > grade, semester and overview in that department's curriculum (empty list if none)
   courses = public_data.curriculum_courses(lectures[0].department_code, lectures[0].course_number)

   Node.js

   import { SejongPublicData } from 'pro-sejongpeia';
   
   const publicData = new SejongPublicData();
   const departments = await publicData.departments({ categoryCode: '20', year: '2026', semesterCode: '20' });
   const lectures = await publicData.lectures({ categoryCode: '20', year: '2026', semesterCode: '20', departmentCode: departments[0].code });

   Create one SejongPublicData per process. The in-memory cache (24 hours by default) and request coalescing live inside the instance.

Plain Java (without Spring)

Spring Boot is an optional dependency, so a plain Java project does not pull it in. The JVM blocks the old TLS cipher the portal accepts, so call SejongTlsSupport.ensureLegacyCipherEnabled() first in main(), before any other HTTPS call.

import kr.suhsaechan.sejongpeia.auth.client.SejongPortalClient;
import kr.suhsaechan.sejongpeia.auth.client.SejongSisClient;
import kr.suhsaechan.sejongpeia.auth.model.SejongAuthResult;
import kr.suhsaechan.sejongpeia.auth.parser.SejongClassicReadingParser;
import kr.suhsaechan.sejongpeia.auth.parser.SejongSisParser;
import kr.suhsaechan.sejongpeia.auth.parser.SejongStudentInfoParser;
import kr.suhsaechan.sejongpeia.auth.service.SuhSejongAuthEngine;
import kr.suhsaechan.sejongpeia.common.config.SejongAuthProperties;
import kr.suhsaechan.sejongpeia.common.util.SejongTlsSupport;

SejongTlsSupport.ensureLegacyCipherEnabled();   // first in main(), before any other HTTPS call
SejongAuthProperties properties = new SejongAuthProperties();
SuhSejongAuthEngine engine = new SuhSejongAuthEngine(new SejongPortalClient(properties), new SejongStudentInfoParser(),
    new SejongClassicReadingParser(), new SejongSisClient(properties), new SejongSisParser());
SejongAuthResult result = engine.authenticate(studentId, password);

Called too late, authentication fails with CONNECTION_FAILED and a message that names the cause. The setting applies to the whole JVM. See Legacy TLS for why. Spring Boot handles it at startup, and Python and Node change only the TLS settings of their own connections.

Call it from a server only

Calling from a browser or app exposes the password to third-party code. The Node package is server-only too. A wrong password sent repeatedly makes the portal lock the account, so if anyone can type a student ID into your form, limit failures per student ID. Login verdict and account lock protection

What an empty list means

When a school server fails, public data returns the last cached value or an empty list without throwing. An empty list can mean “no data” or “a problem on the school side”, so show a hint such as “could not load” next to empty results.

Next

Add student verificationA club sign-up form example and what to watch for.

Department and lecture searchA small server that returns departments and lectures as JSON.

Authentication configurationTimeout, retries, certificate verification.