본문으로 건너뛰기

답안 제출과 기록

답안 제출​

답은 JSON으로 바꿀 수 있는 값이면 됩니다(최대 64KB). 채점은 서버가 교육자의 채점 설정으로 요청 안에서 끝내고, 결과를 바로 돌려줍니다.

개인정보 금지

답에 학습자 개인정보(이름 · 전화번호 · 이메일 · 주소 · 생년월일 · 학번 · 주민번호 · 계좌 · 얼굴 사진 · 위치 등 사람을 알아볼 수 있는 정보)를 넣지 마세요. 제출한 답은 서버에 남아 교육자 · 운영자가 보고, rubric 채점이면 외부 AI 모델로도 갑니다. 학습자를 구분하려면 sdk.account.anonymousId를 씁니다.

const { isCorrect, score, answerCorrectness } = await sdk.submit({ q1: 'B', q2: 42 });
// 자동 채점: { isCorrect: true, score: 100, answerCorrectness: [] }
// 채점 안 함: { isCorrect: null, score: null }

// partial_pattern: 답은 문항 순서대로 문자열 배열
await sdk.submit(['Paris', '4', '광합성']);
// { isCorrect: false, score: 30, answerCorrectness: [false, false, true] }
  • answerCorrectness는 partial_pattern 채점의 문항별 맞음(answer_key 순서, 빠진 답은 false)입니다. pattern · rubric · 채점 안 함은 []입니다.
  • 학습 화면(learn · instructor)에서만 부를 수 있습니다. 설정 화면에서는 screen_not_supported입니다.
  • 튜터가 부르면 read_only_mode로 거절됩니다. 튜터에게는 제출 버튼을 숨기거나 끕니다.
  • 과목 관리자(교육자)가 학습 페이지에서 제출하면 채점만 하고 저장하지 않습니다.
  • 편집 페이지 미리보기(isDraft)에서는 서버에 보내지 않고 채점을 흉내 냅니다.

학습 완료 설정에 따른 결과​

학습 완료 설정 · 채점submit() 결과
on_access (열람 시 학습 완료)score · isCorrect는 null. 처음 열 때 이미 100점으로 기록되고, 제출은 기록만 남김
on_submit (제출 시 학습 완료)바로 100점
on_graded + pattern바로 0점 또는 100점
on_graded + partial_pattern바로 맞은 문항 점수의 합(최대 100). 100점일 때만 isCorrect: true이고 완료. 답이 문자열 배열이 아니면 거절(request_failed, 서버 코드는 cause에)
on_graded + rubric (AI 채점)요청 안에서 AI가 채점해 점수를 돌려줌(최대 30초). AI 호출이 실패하면 제출이 저장되지 않고 external_service_error. 다시 제출하면 됨

자유 구성 학습자료는 교육자 직접 채점과 채점 없음을 쓰지 않습니다. 채점 설정은 자료 정보와 설정 저장을 봅니다.

만점 축하는 LXP가 보여 줍니다

만점 축하(토끼 · 소리)는 서버 점수가 바뀌면 LXP가 보여 줍니다. 콘텐츠는 submit()만 부르고 축하 화면을 따로 만들지 않습니다.

제출 제한​

  • 짧은 시간에 너무 많이 제출하면(분당 30회) rate_limited입니다.
  • 답이 64KB를 넘으면 invalid_input입니다.

제출 기록​

내 제출 기록을 최신순으로 읽습니다. 튜터는 보고 있는 학생의 기록을 읽습니다.

const submissions = await sdk.history({ offset: 0, limit: 20 });
// [{ id, materialVersionId, accountId, createdAt, answer, isCorrect, score, answerCorrectness }, …]
필드설명
id제출 id
materialVersionId제출할 때의 자료 버전 id
accountId제출한 계정 id
createdAt제출 시각
answer제출한 답
isCorrect, score채점 결과. 채점하지 않았으면 null
answerCorrectnesspartial_pattern 문항별 맞음. 다른 채점은 []. 이전 서버는 보내지 않을 수 있음
  • offset 기본값은 0, limit 기본값은 20, 최대 100입니다.

내 결과​

sdk.result는 init() 때 받아 온 자료 단위 결과입니다({ score, submitCount, completedAt }). 화면과 보는 사람을 봅니다.