답안 제출과 기록
답안 제출
답은 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 |
answerCorrectness | partial_pattern 문항별 맞음. 다른 채점은 []. 이전 서버는 보내지 않을 수 있음 |
offset기본값은 0,limit기본값은 20, 최대 100입니다.
내 결과
sdk.result는 init() 때 받아 온 자료 단위 결과입니다({ score, submitCount, completedAt }). 화면과 보는 사람을 봅니다.