>


학습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는 모든 문항에 대해 아래와 같은 세 가지 유형의 자동 채점을 지원하여 학생용 서비스 개발이 가능합니다. 필기 인식 기술이 우수하지만, 아직 완벽하지 않아 수업 흐름을 방해하거나 필기 인식만 가능한 문항를 만들 경우 한계가 있을 수 있습니다. 따라서 이를 감안해 문항를 구축하는 것이 필요합니다

객관식형

aa

범례형 (이미지 범례 가능)

숫자입력형 & 혼합형

단원정보

단원 정보는 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_answerOMR 정답
score_htmlOMR 입력 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