Ally Class

Ally Class Open API 연동 지원 사이트

웹사이트나 HTML기반 컨텐츠에서, 자유롭게 앨리을 생성하고 API 호출을 통하여 실행을 할 수 있도록 지원하기 위한 사이트입니다. 본 API를 사용하면 [이용약관]에 동의하는 것으로 간주합니다. 본사와 협의에 의하여 서비스 제휴사가 되면 [제휴사 이용약관]에 준하여 추가적인 API를 제공 받을 수 있습니다. 모든 문의사항은 고객지원센터로 접수하기 바랍니다.

앨리 생성

API로 실행할 앨리을 생성하기 위한 편집기입니다. 여기에서 편집된 결과를 JSON으로 복사하고 API를 호출하여 실행할 수 있습니다.

앨리생성기

유형 및 예제는 다음과 같습니다.

앨리 실행

(1) 앨리을 사이트에 붙이기 위해서는 다음과 같이 앨리 API 소스를 HTML에 추가합니다.

(2) 예를 들면, 다음과 같이 ally.run() API를 호출합니다. 첫번째 인수가 편집된 앨리 데이터입니다. 두번째 인수는 HTML에서 앨리을 실행한 HTML Tag입니다.

<div onclick="ally.run(['choice','T','다음 내용을 읽고 \'O\' 또는 \'X\'를 선택하세요.다람쥐가 도토리 23개를 4명의 친구에게 5개씩 똑같이 나누어 주었더니 창고에 2개가 남았습니다.',2,'O','X',1,1],this)">실행</div> 복사

(3) 시험 및 검증 절차

①Tag를 클릭하여 앨리이 새 브라우저 창에서 실행되는 것을 확인합니다.

②QR코드로 접속하여 제출하고, 그 결과가 [제출내역]에 표시되는 것을 확인합니다.

③앨리 창을 닫고, ①항의 절차를 반복합니다. 다시 실행된 브라우저 창의 [제출내역]이 그대로 유지되고 있는 것을 확인합니다.

앨리허브 실행

앨리허브는 교사가 수업 중에 필요한 라이브 을 바로 실행할 수 있도록 지원하기 위한 모듈입니다. 다음과 같은 기능을 제공합니다.

①수업용 앨리생성기

②수업용 앨리 갤러리

③앨리 실행 기록

앨리허브는 <IFRAME> Tag에서 실행될 수 있으므로, ally.hub.run()을 호출하여 웹사이트에서 지정한 Tag에 실행시킬 수 있습니다. '과목'과 '학년'은 앨리허브에 연결된 앨리을 검색하기 위한 조건으로 호출하는 웹사이트가 이에 해당하지 않으면 값을 지정하지 않아도 됩니다.

과목 학년

앨리허브

코드보기

앨리 API 규격

위의 문서 및 코드에서 사용된 API의 규격은 다음과 같습니다.

ally.run(/*Array*/data, /*Tag*/tag, /*Object|undefined*/options)

패러미터	값	필수
data	[앨리생성기]에서 편집한 Array형 데이터	O
tag	을 실행한 Tag. 이 Tag에 앨리의 재실행 Context가 저장되므로 실행된 앨리 창을 닫아도 이 Tag가 다시 전달되면 의 제출 결과가 그대로 유지되어 실행되는 것이 보장된다.	O
options	onResult:Function {onResult:function(/{message:String}\|undefined/){...}}와 같이 호출하면 이 API의 실행 결과를 받을 수 있다. Callback 함수의 인수가 {message:String} 형태로 전달되면 개발 오류 등으로 실패한 것이다. saveHistory:Boolean true로 지정하면 실행된 앨리을 사용자의 HTML5 Local Storage에 저장한다. 이것은 앨리허브의 '최근 앨리'에 표시된다. Local Storage에 저장하므로 공용 PC에서는 사용에 주의해야 한다.

'data'에 해당하는 앨리을 실행하고 그 실행 Context를 'tag'에 저장한다.

ally.ping(/*Function*/onResult, /*String|undefined*/keyEnterprise)

패러미터	값	필수
onResult	function(/Boolean/){...} 형태이며, Callback 인수가 true가 아니면 서비스가 중지된 것이다.	O
keyEnterprise	전용 앨리 서버를 소유하고 있는 경우, 서버 등록 번호. 그냥 Open API로 호출하는 경우에는 이 값을 사용하지 않는다.

본 서비스가 현재 정상 제공 중인지 확인한다. 서비스가 중지된 상태이면 UI적으로 실행 버튼을 미리 감출 수 있도록 하기 위한 등의 목적이다.

ally.hub.run(/*Tag*/iframe, /*Object|undefined*/meta)

패러미터	값	필수
iframe	앨리허브를 로딩할 IFRAME Tag	O
meta	이 API를 호출하는 웹사이트 또는 컨텐츠의 메타 정보. {subject:String, grade:String}의 형태이며 각 항목의 값은 본 문서의 [앨리허브]에 있는 [코드보기] 버튼을 통하여 확인할 수 있다.

'iframe'에 해당하는 IFRAME Tag에 앨리허브를 로딩한다. 이때 'meta'가 존재하면 '앨리 갤러리'의 메타 정보로 적용된다. ally.run()에서 saveHistory를 true로 호출한 경우에는 실행된 활동 이력이 이 화면에 표시되며, 만약 IFRAME Tag가 이미 표시 중이라면 이력이 자동으로 반영된다.

앨리 오류 메시지

API의 실행과 관련하여, 앨리에서 표시하는 오류 메시지는 다음과 같습니다.

위의 오류는 실행에 필요한 이미지를 로딩할 수 없는 경우에 표시됩니다. 이것은 이미지 URL 자체의 편집 오류이거나 일시적으로 해당 이미지에 접속되지 않은 경우일 수도 있습니다. 또는, 해당 이미지 사이트에서 CORS 등의 이슈로 접근을 막은 상황에도 해당될 수 있습니다.

Ally Class Open API 이용 약관

본 약관은 블루가㈜(이하 "회사")가 제공하는 Ally Class Open API(이하 "API")의 사용 조건과 사용자 의무 및 회사의 책임 한계를 규정하는 문서입니다.

제1조 (API 제공 목적 및 정의)

1.본 API는 웹사이트나 HTML 기반 콘텐츠에서 Ally Class의 활동을 실행하거나 콘텐츠 허브를 표시할 수 있도록 하기 위한 목적으로 제공됩니다.

2."사용자"란 본 API를 연동하거나 호출하여 서비스를 구성하는 개인, 단체 또는 기업을 의미합니다.

제2조 (이용 조건)

1.본 API는 누구나 사전 허가나 비용 지불 없이 자유롭게 사용할 수 있는 무료 서비스입니다.

2.본 API 호출을 통해 Ally Class의 활동을 실행할 수 있으며, 실행된 활동은 다음과 같은 조건의 무료 사용 정책이 적용됩니다.

•클래스룸 참여 가능 인원: 최대 50명

•결과 저장 가능 활동 수: 최대 3개

•이미지 등 자원에 Data URI를 사용할 수 없음

3.본 API는 서비스 구조 변경, 보안 강화, 내부 정책 등에 따라 사전 고지 없이 변경되거나 중단될 수 있습니다.

4.사용자가 본 API를 사용하는 것은 본 약관의 내용에 동의한 것으로 간주합니다.

제3조 (책임의 제한)

1.회사는 본 API의 지속적인 제공, 유지/보수 및 기술 지원에 대한 어떠한 보장도 하지 않습니다.

2.본 API 사용에 따른 직접적 또는 간접적 손해(예: 데이터 손실, 사용자 불만, 매출 손해 등)에 대해 회사는 어떠한 법적 책임도 지지 않습니다.

3.사용자는 본 API를 사용할 때 발생하는 모든 결과에 대한 책임을 스스로 부담합니다.

제4조 (사용 제한 및 금지 행위)

1.사용자는 본 API를 다음의 목적이나 방식으로 사용해서는 안 됩니다.

•불법적이거나 부정한 목적의 사용

•저작권, 초상권 등 제3자의 권리를 침해하는 콘텐츠 실행

•본 서비스의 안정성을 위협하거나 부하를 유발하는 방식으로 과도한 호출

2.위 사항을 위반할 경우, 회사는 본 API 호출 차단 또는 법적 조치를 취할 수 있습니다.

제5조 (약관의 변경)

1.본 약관은 예고 없이 변경될 수 있으며, 변경 사항은 본 사이트 또는 별도 안내를 통해 공지됩니다.

2.변경된 약관은 공지 시점부터 즉시 효력을 갖습니다.

제6조 (준거법 및 분쟁 해결)

1.본 약관에 관한 분쟁은 대한민국 법률을 기준으로 해석하며, 관할 법원은 서울중앙지방법원으로 합니다.

[부칙]

본 약관은 2025년 7월 31일에 게시되었으며, 동일한 날부터 시행됩니다.

Ally Class Open API 제휴사 이용 약관

본 약관은 블루가㈜(이하 "회사")와 공식 제휴를 체결한 제휴사(이하 "제휴사")가 Ally Class Open API(이하 "API")를 이용하는 데 있어 준수해야 할 조건, 권리 및 의무를 규정합니다.

제1조 (약관의 적용)

1.본 약관은 Ally Class Open API 이용 약관(이하 "기본 약관")을 기본으로 하며, 제휴사에게 추가적으로 적용됩니다.

2.본 약관과 기본 약관의 내용이 상충하는 경우, 개별 제휴 계약서 또는 본 약관의 내용이 우선 적용됩니다.

제2조 (제휴사의 정의 및 승인 절차)

1."제휴사"란 회사와 사전 협의를 거쳐 공식적으로 승인된 기관, 기업 또는 단체를 의미합니다.

2.회사는 제휴 승인 여부 및 지원 범위에 대해 최종적인 판단 권한을 가집니다.

제3조 (추가 서비스 제공)

1.제휴사에게는 협의 또는 계약에 따라 아래와 같은 추가 기능 또는 기술 지원이 제공될 수 있습니다.

•추가적인 유형의 앨리 생성 기능

•기타 제휴 목적에 부합하는 추가적인 API 또는 서비스

2.제공 범위 및 조건은 개별 협의 또는 계약서를 통해 구체적으로 정합니다.

제4조 (의무 및 책임)

1.제휴사는 본 약관 및 기본 약관의 모든 조항을 성실히 이행해야 하며, 부정 사용이 확인될 경우 회사는 API 호출을 차단하거나 이용을 제한할 수 있습니다.

제5조 (기타 조항)

1.제휴와 관련된 상세 조건, 기술 지원 범위, 운영 방식 등은 별도의 계약서 또는 협약서를 통해 정할 수 있습니다.

2.본 약관은 회사의 판단에 따라 예고 없이 변경될 수 있으며, 변경 시 본 사이트 또는 제휴사에게 개별 연락을 통해 고지됩니다.

제6조 (계약의 해지 및 종료)

1.제휴사는 회사와의 협의 또는 계약에 따라 제휴를 해지할 수 있으며, 해지 즉시 관련 API 사용 권한은 종료됩니다.

2.회사는 제휴사가 본 약관 또는 개별 계약 조건을 위반한 경우, 제휴를 해지하거나 관련 서비스 제공을 중단할 수 있습니다.

[부칙]

본 약관은 2025년 7월 3일에 제정되었으며, 해당 제휴사와의 계약 체결일로부터 적용됩니다.