Skip to content

Latest commit

 

History

History
118 lines (89 loc) · 4.45 KB

README.md

File metadata and controls

118 lines (89 loc) · 4.45 KB
Raw

How to parse Comcigan

Warning

컴시간알리미 측에선 3rd party 앱을 허용하지 않기 때문에, 이 문서에서 설명할 방법은 언제든지 작동을 멈출 수 있습니다. 또한 이 문서는 오로지 학습 목적으로 작성되었으며, 이를 통해 발생하는 모든 문제에 대해 작성자는 책임지지 않습니다.

이 문서에선 컴시간알리미를 파싱하는 방법에 대해서 설명합니다.

Getting Started

Base URL: http://comci.net:4082 (protocol이 http인 것에 주의)

컴시간알리미는 일정 주기마다 모든 route와 응답의 구조를 변형합니다. 따라서 GET /st을 요청해 응답을 EUC-KR로 decode한 뒤, 아래 테이블의 정규표현식을 사용해 route와 code를 추출해야 합니다.

Name RegExp
mainRoute (?<=\.\/)\d+(?=\?\d+l)
searchRoute (?<=\?)\d+(?=l)
timetableRoute (?<=')\d+(?=_')
teacherCode (?<=성명=자료\.자료)\d+
originalCode (?<=원자료=Q자료\(자료.자료)\d+
dayCode (?<=일일자료=Q자료\(자료.자료)\d+
subjectCode (?<=자료.자료)\d+(?=\[sb\])

또한 GET /st를 제외한 모든 응답은 Null 문자들을 포함하고 있기 때문에 이를 제거해야 파싱이 수월합니다. 후술할 내용들은 모두 응답의 Null 문자들을 제거한다는 가정하에 작성되었습니다.

Endpoints

학교 검색

학교를 검색하기 위해선 먼저 학교 이름을 EUC-KR로 encode해야 합니다. 이후 GET /{mainRoute}?{searchRoute}l{인코딩된 학교 이름}을 요청하면 다음과 같은 응답을 받을 수 있습니다.

{
  "학교검색": [
    {
      12345, // 알 수 없는 값 (comcigan.ts에선 지역 코드로 사용)
      "서울", // 지역 이름
      "ㅇㅇ중학교", // 학교 이름
      12345 // 학교 코드
    },
    ...
  ]
}

시간표 조회

시간표를 조회하기 위해선 상술한 학교 검색을 통해 학교 코드를 알아내야 합니다. 이후 {timetableRoute}_{학교 코드}_0_1을 base64로 encode하고, GET /{mainRoute}?{인코딩된 param}를 요청하면 다음과 같은 응답을 받을 수 있습니다.

Note

'원자료'는 원래 일과 시간표, '일자료'는 일일 시간표를 의미합니다. 원자료와 일자료는 다를 수 있고, 특정 교시에 대해선 둘 중 하나만 존재할 수도 있습니다.

{
  "자료{teacherCode}": [
    "*", // 교사의 개인정보 보호를 위해 사용되는 문자
    "ㄱㄴ*",
    "ㄹㅁ*",
    ...
  ],
  "자료{subjectCode}": [
    12, // 과목 개수
    "국어",
    ...
  ],
  "자료{originalCode}": [
    3, // 원자료 학년 개수
    [
      10, // 원자료 1학년 반 개수
      [
        5, // 원자료 1학년 1반 요일 개수
        [
          6, // 원자료 1학년 1반 월요일 교시 개수
          12345, // 원자료 1학년 1반 월요일 1교시 코드
          ...
        ],
        ...
      ],
      ...
    ],
    ...
  ],
  "자료{dayCode}": [
    /* 원자료와 구조 동일 */
  ]
}

교시 코드에서 교사와 과목을 알아내기 위해선 다음과 같은 작업이 필요합니다.

  1. teachersLen을 다음과 같이 정의합니다. (교사 수를 10진수로 표현했을 때의 자릿수를 의미합니다)

$$\lfloor \log_{10}(\text{{amount of teachers}}) \rfloor + 1$$

  1. 교사 코드는 다음과 같고, 응답의 자료{teacherCode}에서 index 교사 코드의 값이 교사 이름입니다.

$$ \text{{교시 코드}} \mod 10^{\text{{teachersLen}}} $$

  1. 과목 코드는 다음과 같고, 응답의 자료{subjectCode}에서 index 과목 코드의 값이 과목 이름입니다.

$$ \left\lfloor \frac{\text{{교시 코드}}}{10^{\text{{teachersLen}} + 1}} \right\rfloor $$

Changelog

2024-08-10

  • User-Agent 관련 내용 삭제 (불필요한 정보)
  • route 및 응답 구조 변형 주기 관련 내용 삭제 (불확실한 정보)
  • 학교 검색 결과의 1번째 값이 지역 코드가 아닐 수 있다는 것을 명시
  • 단어 형태 수정 (디코딩 -> decode)

2024-07-16

  • 교사 코드 및 과목 코드 계산 방법 변경 (string slice w/ type conversion -> modulo operation, floor division)

2024-07-14

  • 문서 최초 작성