학습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 |