AVALON × PLANG / DEVELOPERS아발론 플랭 연동 문서

암호화 코드로 시작하는 학습 연동.
활동 지정부터 평가 결과 조회까지 안내합니다.

연동 가이드 시작하기 →

API 요청 · 응답 보기

학생 등록부터 자동으로

학생 ID와 기수 정보를 보내면 필요한 학생과 그룹을 생성합니다. 학생 수 제한 없이 연동할 수 있습니다.

학생 · 그룹 생성 규칙

로그인 없이 지정 학습으로

아발론 서버가 생성한 코드를 학습 창에 form POST합니다. 학생은 지정된 활동만 수행하고, 제출을 완료하면 창을 닫습니다.

암호화 코드로 학습 시작

아발론의 기준으로 평가

RA·WR·SP 평가 결과와 전체 종합 코멘트를 학습 차시별로 조회합니다. WR·SP에는 아발론 루브릭을 적용합니다.

결과 제공 범위

연동은 네 단계로 이어집니다.

키는 서버에서 관리하고, 학생 창에는 일회용 암호화 코드를 전달합니다.

01 / SELECT

활동 확인

CSV API로 플랭에 등록된 6개 값 조합과 활동명을 확인합니다.

02 / LAUNCH

코드로 직접 진입

학생 ID와 6개 값·귀속 월을 암호화해 새 학습 창으로 전달합니다.

03 / LEARN

학습 수행 · 제출

로그인 화면 없이 학습을 시작하고 제출 완료 후 학습 창을 닫습니다.

04 / RESULTS

평가 결과 조회

학생 ID와 6개 값으로 분석 상태와 평가 결과, 종합 코멘트를 조회합니다.

문서 상태 · 개발 명세 v0.4
2026년 10월 7일 기준입니다. 암호화 규약과 운영 수치를 확정했고, 테스트 환경에서 학습 진입·활동 CSV·학습이력 조회를 확인할 수 있습니다. 결과 조회 API는 개통 전입니다. 플랭의 준비 사항과 양사 테스트 항목은 연동 준비 및 확인 사항에서 확인할 수 있습니다.