KLASSLAB API / V1
API 키
필요한 권한만 부여하고 안전하게 연결하세요.
키 발급과 권한
대표자 계정으로 키 관리에서 발급합니다. 개발용·운영용 키를 나누고 필요한 scope만 선택하세요. 일반 웹 구독과 API 구독은 별개입니다.
Authorization: Bearer <API_KEY>키 보관
- 키는 발급 직후 한 번만 표시되며 서버에는 해시만 보관합니다.
- 서버 환경변수나 비밀 저장소에 보관하세요. 브라우저 코드·앱 소스·URL·로그에 넣지 마세요.
- API Explorer에 입력한 키는 저장하지 않습니다. 공용 기기에서 입력하지 마세요.
- 유출되면 기존 키를 폐기하고 새 키를 배포하세요. 만료·폐기된 키는 호출할 수 없습니다.
사용 가능한 권한
필요한 기능만 허용하세요. .read는 조회, .write는 등록·수정 등 관리 작업에 사용하는 별도 권한입니다. 두 작업이 모두 필요하면 두 권한을 함께 선택하세요. grading.omr는 크레딧 차감 동의가 필요한 OMR 채점 실행 권한입니다.
| 기능·권한 코드 | 허용되는 작업 | 상세 API |
|---|---|---|
출결·입퇴실 조회attendance.read | 수업별 출석부, 학생별 출결 합계와 입퇴실 기록을 확인합니다. | API 목록 → |
입퇴실 기록 관리attendance.write | 학생 입퇴실 기록을 등록하거나 삭제합니다. 수업 출결 수정은 수업·과제장 관리 권한입니다. | API 목록 → |
교재·출고 조회books.read | 교재비 항목과 학생별 출고·반품·수납 현황을 확인합니다. | API 목록 → |
교재·출고 관리books.write | 교재비 항목과 출고 기록을 등록·수정·삭제하고 반품·수납 상태를 변경합니다. | API 목록 → |
상담 예약 조회consultations.read | 상담 예약 목록·상세와 담당자를 확인합니다. | API 목록 → |
상담 예약 관리consultations.write | 상담 예약을 등록·변경·완료·취소하거나 삭제합니다. | API 목록 → |
OMR 채점 실행grading.omr | 업로드한 답안을 OMR로 채점합니다. 장수에 따른 크레딧 차감 동의가 필요합니다. | API 목록 → |
시험·성적 조회grading.read | 시험·정답·학생별 답안과 점수, OMR 양식, 작업 상태와 사용량을 확인합니다. | API 목록 → |
시험·답안 관리grading.write | 시험·정답·성적을 관리하고 파일 업로드, XLSX 답안 가져오기와 재계산을 신청합니다. OMR 실행은 별도 권한입니다. | API 목록 → |
학생 생활기록 조회life.read | 생활기록 항목과 학생별 기록을 확인합니다. | API 목록 → |
학생 생활기록 관리life.write | 생활기록 항목을 설정하고 학생별 기록을 저장하거나 삭제합니다. | API 목록 → |
messages.readmessages.read | 이 권한에 포함된 API는 레퍼런스에서 확인하세요. | API 목록 → |
messages.writemessages.write | 이 권한에 포함된 API는 레퍼런스에서 확인하세요. | API 목록 → |
직원 기본정보 관리staff.manage | 출퇴근용 직원의 이름·직무·입퇴사일을 등록·수정하고 퇴사 처리합니다. 비밀번호·급여는 변경하지 않습니다. | API 목록 → |
직원 근무 조회staff.read | 직원 목록과 출퇴근·근무일지, 근무 시간 합계를 확인합니다. | API 목록 → |
직원 근무 관리staff.write | 직원의 출퇴근 기록과 근무일지를 등록·수정·삭제합니다. | API 목록 → |
statistics.readstatistics.read | 이 권한에 포함된 API는 레퍼런스에서 확인하세요. | API 목록 → |
학생·수강 이력 조회students.read | 학생 기본정보와 수강 이력을 검색하고 확인합니다. | API 목록 → |
학생·수강 관리students.write | 학생 정보를 등록·수정·삭제하고 수강 등록과 퇴원을 처리합니다. | API 목록 → |
수업·과제장 조회teaching.read | 수업·과제장과 학생별 결과, 보강·재검사 일정, 클리닉 기록을 확인합니다. | API 목록 → |
수업·과제장 관리teaching.write | 수업·명단·출결·검사 결과를 관리하고 보강 연결, 재검사·클리닉 기록을 처리합니다. | API 목록 → |
수강반·시간표 조회teams.read | 수강반 정보와 반별 시간표를 확인합니다. | API 목록 → |
수강반·시간표 관리teams.write | 수강반·시간표를 등록·수정·삭제하고 종강·종강 취소를 처리합니다. | API 목록 → |
학원은 키에서 결정합니다. 요청에 다른 학원 번호를 넣어도 접근 범위가 바뀌지 않습니다. 직접 발급한 키의 유효기간은 1~365일 또는 만료 없음이며 MCP 연결·재연결이 이 키의 만료일을 변경하지 않습니다. MCP 연결은 별도로 최대 90일 유지됩니다.