학습API
ClassCube 기본 API이면 c2Math 서비스에서 사용됩니다. c2Math을 사용해보시면서 ClassCube API을 경험해 보세요. 고객 맞춤형 API를 제작해 드릴 수 있습니다. 자세한 사항은 언제든지 문의해 주세요!
문항전송
문항 ID를 입력하면 해당 문항 정보를 JSON 형식으로 제공합니다.
- JSON 필드에 대한 설명은 왼쪽 메뉴의 "문항 JSON 필드" 항목을 참조하시기 바랍니다.
- 문항의 HTML은 "자동채점" 메뉴에서 확인할 수 있습니다.
- 문항의 CSS는 사이트나 페이지 스타일에 맞게 수정 가능합니다.
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
/[제휴사코드]/questions
샘플링크 |
ids=258214,239270,245511 | 필수 | 문항 ID, 문항 ID, 문항 ID, … |
group_yn=n | n | 지문그룹핑 여부 |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 c : 문항수 d : [ {queston json}, {queston json}, … ] 문항 데이터 Array scopes : 지문 그룹 문자
c2Math내 사용예
시험지 미리보기
테블릿 보기
출제마법사
출제 마법사는 검색 기반으로 개발되어 국내 최고 속도의 성능을 자랑합니다. 이 기술을 통해 시험지 내 쌍둥이 문항을 자동으로 걸러냅니다. 또한, 문항 유형에 상관없이 사용할 수 있는 wizard_v1과 문항 유형별로 구분할 수 있는 wizard_v2 두 가지 형태를 지원하여 더욱 유연한 출제 환경을 제공합니다.
Wizard V1 인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
/[제휴사코드]/wizards_v1
샘플링크 |
chapters=MA1507C01,MA1507C02 | 필수 | 단원코드1,단원코드2 |
levels=0,10,10,10,0 | "" | 하,중하,중,중상,상 문항수분포 | |
hmls=2,3,2 | "" | 상,중,하 문항수 분포 | |
sort=j | j | 소팅방법: j(진도), p(평가) |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 c : 문항수 d : [ {queston json}, {queston json}, … ] 문항 데이터 Array scopes : 지문 그룹 문자
Wizard V2 인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
/[제휴사코드]/wizard_v2
샘플링크 |
chapters=MA1507C01,MA1507C02 | 필수 | 단원코드1,단원코드2 |
ch_levels=0,10,10,10,0 | "" | 객관식 하,중하,중,중상,상 문항수분포 | |
sa_levels=0,10,10,10,0 | "" | 주관식 하,중하,중,중상,상 문항수분포 | |
ch_hmls=2,3,2 | "" | 객관식 상,중,하 문항수 분포 | |
sa_hmls=2,3,2 | "" | 주관식 상,중,하 문항수 분포 | |
sort=j | j | 소팅방법: j(진도), p(평가) |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 c : 문항수 d : [ {queston json}, {queston json}, … ] 문항 데이터 Array scopes : 지문 그룹 문자
c2Math 출제마법사
조판
수학 시험지 출력 시 여백 관리가 중요합니다. 균등한 배분을 통해 깔끔한 시험지를 빠르게 출력할 수 있도록 최적화되었습니다.
- 한글과 PDF 두 가지 조판 방식을 지원하며, 10pt, 11pt, 12pt 크기의 문항를 제공합니다.
- 고객사의 맞는 다양한 형태의 시험지 제작이 가능합니다.
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
조판 /[제휴사코드]/print |
ids=397411,397412 | 필수 | 조판할 문항 ID, 형식:문항ID, 문항ID,문항ID, … |
pdf=y | y | y: pdf 파일생성, n:한글 파일 생성 | |
even_yn=y | y | y:짝수페이지(양면인쇄시이용), n:홀수 페이지 | |
template=1 | 1 | 인쇄 template 번호 | |
font_size=1000 | 1000 | 1000:10pt, 1100:11pt, 1200:12pt | |
bline=3 | 3 | 문항 사이의 공백 라인수 | |
pt=exam | exam | 인쇄 타입 - exam: 시험지, answer: 정답지, explanation: 풀이지, all: 문항+풀이 | |
추가 인자 | 로고, QR, 학원명, 학생명, 시험지명, 출제일, 클래스명, 학습학년등 조판시 출력할 매개변수 |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 m : pdr url or hwp url
c2Math 조판
쌍둥이문항검색
쌍둥이문항검색은 LMS상에서 많이 사용됩니다. 출제마법사를 사용할 때는 중복 또는 유사한 문항를 제거하여 균형 잡힌 시험지를 구성하는 데 도움을 주고, 학생의 오답노트를 작성할 때는 학생이 틀린 문항와 최대한 비슷한 문항를 찾아 제공하여 학습 효과를 높이는 데 기여합니다.
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
/[제휴사코드]/search_question
샘플링크 |
id=397411 | 필수 | 문항 ID |
count=10 | 10 | 최대 출력 문항 수 | |
difficulty_yn=n | n | 난이도 매칭 [y/n] | |
type_yn=n | n | 문항타입 매칭 [y/n] | |
rate=70 | 70 |
유사도: 0 ~ 100 ex) rate=70이면 유사도 70이상 문항를 출력 |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 c : 문항수 d : [ {queston json}, {queston json}, … ] 문항 데이터 Array
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
/[제휴사코드]/search_chapter
샘플링크 |
chapters=MA1502A03 | 필수 | 단원 |
count=10 | 10 | 출력 문항 수 | |
type=ch | "" | 문항타입 ch:객관식, sa:주관식 | |
difficulty=3 | "" | 난이도 1~5 | |
page=1 | 1 | 페이지 |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 sc : 쌍둥이 문항수 sd : [ {queston json}, {queston json}, … ] 문항 데이터 Array cc : 유형유사 문항수 cd : [ {queston json}, {queston json}, … ] 문항 데이터 Array
c2Math 검색
맞춤학습
c2Math에서는 지식맵 기반으로 스마트 오답노트, 기초 보강, 미학습 유형, 실력 향상 엔진을 구축하여 운영 중입니다. 또한, 다른 고객사와 협업하여 각 고객사가 필요로 하는 지식맵 기반 학습 모델을 개발한 경험을 보유하고 있습니다.
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
학생의 정오답을 저장 /[제휴사코드]/save_results |
exam_id=12 | 필수 | 시험지ID |
student_id=412 | 필수 | 학생ID | |
ids=397411,397412 | 필수 | 문항 ID 목록 (콤마로 구분) | |
ox=o,x,x,x,o,x | 필수 | 문항 채점 결과 (콤마로 구분) |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0
인자설명
Method | Input | default값 | 인자설명 |
---|---|---|---|
학생의 정오답을 저장 /[제휴사코드]/recommend |
chapters=MA1502106,MA1502107 | 필수 | 추천 학습 단원 |
student_id=412 | 필수 | 학생ID | |
count=20 | 필수 | 추천 문항수 | |
mode=b | b | b:기초보강, r:맞춤형 d:심화보강, m:미학습개념 |
출력
r : r==0 success, r>0 fail m : 오류 메시지 if r > 0 c : 문항수 d : [ {queston json}, {queston json}, … ] 문항 데이터 Array scopes : 지문 그룹 문자
c2Math 맞춤학습
자동채점
ClassCube는 모든 문항에 대해 아래와 같은 세 가지 유형의 자동 채점을 지원하여 학생용 서비스 개발이 가능합니다. 필기 인식 기술이 우수하지만, 아직 완벽하지 않아 수업 흐름을 방해하거나 필기 인식만 가능한 문항를 만들 경우 한계가 있을 수 있습니다. 따라서 이를 감안해 문항를 구축하는 것이 필요합니다
단원정보
단원 정보는 API를 통해 전송이 가능하지만, 실제 개발 과정에서는 Excel 형식으로 단원 정보를 제공하고 양사가 협력하여 개발하는 방식이 더 효율적이었습니다. 제공되는 정보는 아래 형식을 따르며, API는 유형 코드 기반으로 작동합니다. 자체 단원 정보를 보유한 경우, 제공된 유형 코드를 매핑하여 사용할 수 있습니다.
단원정보 구조
과목 | 대단원 | 유형코드 | 중단원 | 유형코드 | 소단원 | 유형코드 | 유형 | 유형코드 |
---|---|---|---|---|---|---|---|---|
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 01. 포물선의 정의와 방정식 | MA1516C01010101 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 02. 포물선의 평행이동 | MA1516C01010102 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 03. 포물선의 정의 활용하기(포물선 위의 점이 주어질 때) | MA1516C01010103 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 04. 포물선의 정의 활용하기(초점을 지나는 직선이 주어질 때) | MA1516C01010104 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 05. 길이의 합의 최솟값 구하기 | MA1516C01010105 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 06. 포물선의 자취의 방정식 | MA1516C01010106 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 01. 포물선 | MA1516C010101 | 07. 포물선의 방정식 활용하기 | MA1516C01010107 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 01. 타원의 방정식 | MA1516C01010201 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 02. 타원의 초점, 꼭짓점, 장축, 단축 | MA1516C01010202 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 03. 타원의 평행이동 | MA1516C01010203 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 04. 타원의 정의 활용하기 | MA1516C01010204 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 05. 타원의 정의로 최대, 최소 구하기 | MA1516C01010205 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 06. 타원의 자취의 방정식 | MA1516C01010206 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 02. 타원 | MA1516C010102 | 07. 타원의 방정식 활용하기 | MA1516C01010207 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 01. 쌍곡선의 방정식 | MA1516C01010301 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 02. 쌍곡선의 평행이동 | MA1516C01010302 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 03. 쌍곡선의 점근선 | MA1516C01010303 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 04. 쌍곡선의 정의 활용하기 | MA1516C01010304 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 05. 쌍곡선의 자취의 방정식 | MA1516C01010305 |
기하(2015) | 01. 이차곡선 | MA1516C01 | 01. 이차곡선의 방정식 | MA1516C0101 | 03. 쌍곡선 | MA1516C010103 | 06. 이차곡선의 이해 | MA1516C01010306 |
인자설명
json필드명 | 설명 | 비고값 |
---|---|---|
id | 문항 ID | |
question_id | 문항 ID | |
question_group_id | 지문 ID | |
sentence_html | 지문 html if( 지문 ID != "" ) | |
question_type_cd | 문항 타입 코드 | |
question_type_cd_value | 문항 타입 | |
difficulty_cd | 난이도 코드 | |
difficulty_cd_value | 난이도 | |
body_html | 문항 html | |
body_ex_html | 문항 선택이 이후 문항 html | |
list_type | 선택지모양 | |
list_html | 테이블 선택지 html | |
list_html_arr | 보통 선택지 html | |
answer_html | 정답 HTML | |
answer_txt | 정답 TXT | |
explanation_html | 해설 HTML | |
score_answer | OMR 정답 | |
score_html | OMR 입력 html | |
question_group_img | 지문 이미지 | |
question_body_img | 문항 본문 이미지 | |
question_list_img | 문항 선택지 이미지 | |
question_answer_img | 정답이미지 | |
question_explanation_img | 해설 이미지 | |
analysis_id | 분석영역ID | |
analysis_value | 분석영역명 | |
studytree_id | 내용영역ID | |
studytree_value | 내용영역명 | |
chapter_code | 표준단원코드 | |
chapter_code_name | 표준단원명 | |
math_grade_cd | 수학과목코드 | |
math_grade_value | 수학과목명 | |
path_codes | 포준 단원 codes Path | |
path_str | 포준 단원 Path |