웹로그

API 센터

Open API 신청

Open API는 EBS 클립뱅크에서 서비스하는 클립데이터를 손쉽게 검색할 수 있도록 연계할 수 있는 기술로 비상업적인 용도로만 무료로 공개되며, 인증을 거친 후 사용하실 수 있습니다.
인증절차는 EBS 클립뱅크의 운영과 관련하여 일부 제약이 있을 수 있습니다.

요청 URL(request url)

http://clipbank.ebs.co.kr/openapi

요청 변수(request parameter)

요청변수 변수명 설명
key 인증키 이용 등록을 통해 받은 key를 입력합니다. 필수값
type 검색대상 검색할 대상을 지정합니다. 필수값
ALL : 전체
VOD : 동영상 클립
IMG : 이미지 클립
query 검색키워드 검색을 원하는 질의어를 입력합니다.
반드시 UTF-8로 인코딩되어야 합니다.
필수값
curPage 페이지번호 검색의 시작 페이지 번호를 지정합니다.
listCnt 검색결과수 한 페이지에 보여줄 목록의 수를 지정합니다.
sort 정렬조건 RANK: 정확도 내림차순
DATEDesc: 날짜 내림차순
DATEAsc: 날짜 오름차순
· 요청 URL 예제 (‘클립뱅크’를 검색할 경우)

http://clipbank.ebs.co.kr/openapi?key=0d86129e-d9f3-44db-9c37-ed098bd8e044&type=ALL&query=클립뱅크&curPage=1&listCnt=10&sort=RANK

출력결과 필드(respoond field)

요청변수 변수명 설명
request 요청내용 요약 요청된 결과를 요약합니다.
collection: 요청한 검색대상을 표시합니다.
query: 요청한 검색 키워드를 표시합니다.
listCount: 요청한 페이지당 결과수를 표시합니다.
result 검색결과 요약 검색된 결과를 요악합니다.
total: 총 검색된 클립 수를 표시합니다.
curPage: 검색결과의 시작 페이지 번호를 표시합니다.
resultValues 검색결과 검색결과를 모두 포함하는 컨테이너입니다.
resultValues 검색항목 검색결과에 대한 항목 하나에 대한 컨테이너입니다.
이 태그 하위의 값들을 활용합니다.
Date 등록일 등록일
CLIP_ID 클립 ID 클립 ID입니다.
CLIP_CLS_NM 클립유형 클립유형을 표시합니다.
VOD: 동영상
IMG: 이미지
TITLE 클립명 클립명을 표시합니다.
LINK 상세페이지 URL 클립 상세 정보 URL을 표시합니다.
CONTENT 설명 클립에 대한 설명입니다.
CLIP_PLAY_TIME 동영상 재생시간 동영상일 경우 재생시간으로 초단위로 표시됩니다.
CONTENT_CATE 교과분류체계 교육과정 분류체계 위계를 표시합니다.
THUMB_URL 썸네일 URL 클립의 썸네일 URL을 표시합니다.
CLIP_PLAY_URL 클립 재생 URL 클립 바로가기 URL을 표시합니다.
DETAIL_QR_CODE 상세페이지 QR코드 클립상세페이지 QR 코드를 표시합니다.
PLAY_QR_CODE 클립 재생 QR코드 클립 바로보기 QR 코드를 표시합니다.
· 샘플 결과 XML

출력결과 필드(respoond field)

에러코드 설명
100 시스템 에러
200 질의 키워드 에러
300 인증키 오류
400 인증키 만료
500 검색대상 데이터 오류
600 정렬조건 데이터 오류
700 검색결과수 데이터 오류
800 서비스 도메인 오류
900 기타 오류
Open API는 초등, 중학, 고등학교의 교수학습영역의 활용에만 지원됩니다.