사전 준비와 역할

항목	준비 내용
조직	플랭에서 아발론 조직을 사전 설정합니다. 학습 요청마다 조직을 생성하지 않습니다.
학습 활동	아발론 서버는 활동 목록 CSV 다운로드 API에서 class_task_id와 활동명을 받아 대상 ID를 실행 API에 전달합니다. 활동 하나는 RA·WR·SP 중 한 유형이며 복합 활동은 제공하지 않습니다.
인증 키	플랭이 제공하는 서버 전용 키를 아발론 서버에서 보관합니다. 학생 브라우저에 전달하지 않습니다.
학생	아발론의 고정 학생 ID만 전달합니다. 학생 이름은 받지 않으며, 아발론 연동 범위의 학생 ID로 동일 학생을 판별합니다.
그룹	level을 OrgGroupSet, layer를 그 아래 OrgGroup에 연결합니다. 별도 그룹 ID·이름은 전달하지 않습니다.
기수	regYear + season으로 구분합니다. 둘 중 하나라도 바뀌면 같은 level·layer여도 새 OrgGroupSet·OrgGroup을 생성합니다. 학생 ID와 이전 기수 이력은 유지합니다.
루브릭	아발론이 제공한 루브릭을 대상 태스크에 항상 설정합니다. 실제 평가항목·점수 범위·배점 기준을 사용합니다.

학생 사전 일괄 등록은 필요하지 않습니다. 학습 요청 시 학생 ID를 확인하고 없으면 자동 생성합니다. 아발론은 사용량 기반으로 이용하며, 학생 수 상한 없이 추가할 수 있습니다. 좌석 수나 개인 이용권으로 등록·학습을 제한하지 않으며 학생 비활성화 절차도 없습니다. 같은 학생의 동일 기수 내 level·layer는 고정이며, 학적 변경과 기존 계정 연결·병합은 연동 범위에 포함하지 않습니다.

활동 목록 CSV 다운로드

GET /integrations/v1/class-tasks.csv

아발론 서버가 서버 전용 키로 호출하면 현재 생성이 완료된 연동 대상 활동의 ID·활동명 목록을 CSV 파일로 받습니다. 새 활동이 추가되거나 활동명이 변경되면 다시 다운로드하여 목록을 갱신합니다.

Authorization: Bearer <PARTNER_SERVER_KEY>
Accept: text/csv

성공 응답은 JSON이 아닌 CSV 파일입니다.

Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="class-tasks.csv"

CSV 컬럼	의미
class_task_id	학습 실행 API에 전달할 활동 ID
class_task_name	활동명

class_task_id,class_task_name
12345,MA RED Unit 1 읽기
12346,MA RED Unit 1 쓰기
12347,MA RED Unit 1 말하기

위 ID·활동명은 설명용입니다. 실제 응답은 다운로드 시점의 연동 대상 목록입니다. 활동명이 바뀌어도 ID를 기준으로 연결하고, 같은 이름의 활동을 이름만으로 합치지 않습니다. 대상이 없으면 헤더만 있는 CSV를 반환합니다. 인증 오류 등 실패 시에는 공통 JSON 오류 응답을 반환합니다. CSV는 아발론 서버가 내려받으며 학생 학습 창에는 활동 목록을 제공하지 않습니다.