만화규장각

OPEN API

OPEN API 란?

Open API란 Open Application Programming Interface의 약자로 누구나 사용할 수 있도록 공개된 API를 말합니다. 기관이 보유한 다양한 정보나 애플리케이션 등을 타 정보 시스템에서 활용할 수 있도록 공개하는 것으로 외부에서 웹프로토콜로 웹컨텐츠를 호출하여 외부개발자나 사용자(혹은 시민)가 직접 데이터를 활용할 수 있도록 하는 사용자 중심의 비즈니스 모델입니다.

만화규장각 API 소개

한국만화영상진흥원 만화규장각에서는 누구나 쉽게 통계데이터 및 시스템 내 공공데이터를 활용하여 웹 서비스 및 어플리케이션 개발 등을 할 수 있도록 Open API 형태로 데이터를 제공하고 있습니다.

만화규장각과 동일한 최신의 도서,유통,웹툰 정보를 제공합니다.
앱, 웹서비스 대상의 Application을 개발할 수 있도록 제공합니다.

API 사용절차

STEP1. 회원가입

만화규장각 OPEN API는 실명인증을 통하여 가입한 인증회원에게만 제공됩니다. 서비스를 이용하실 경우 회원가입을 진행 하셔야 합니다.
회원가입 하기
STEP2. 인증키 발급

회원가입 후 로그인 한 사용자에게만 인증키 발급이 가능합니다. OPEN API 간편 신청서를 작성하고 인증키를 발급받습니다. 인증키는 관리자 승인 후 사용이 가능합니다.
STEP3. 관리자 승인

인증키 발급 신청자에 한하여 관리자가 승인 처리를 진행합니다. 영업일 기준 신청 후 24시간 이내로 승인됩니다. (단, 토요일,일요일,공휴일,휴관일 제외)
STEP4. API 활용

웹 데이터 수집, 앱 어플리케이션 서비스 등 사용자의 목적에 맞게 OPEN API를 활용합니다.

만화규장각 데이터 조회 서비스

활용승인 절차 : 개발/운영 구분 없이 관리자 승인 후 활용가능
신청가능 일일 트래픽 : 1,000
소장 도서 조회 서비스URL : http://서비스URL주소/openapi/search/dcmtDtaList
도서 웹툰 조회 서비스URL : http://서비스URL주소/openapi/search/bookAndWebtoonList

요청변수(Request Parameter)

항목명(영문): 항목명(국문); 데이터형; 필수값; 기본값; 최대값; -

prvKey: 인증키값; String; Y; 승인 시 키값 발급

listSeCd: 목록 구분코드; String; N; 1  :  웹툰
2  :  도서(만화책)
3  :  잡지
4  :  영화
5  :  드라마
6  :  게임
7  :  공연,전시
8  :  행사(전시,행사,축제,컨퍼런스,공모전)
9  :  상품

pageNo: 현재 페이지번호; String; N; 0

viewItemCnt: 표시 항목 수; String; N; 10; 100

startDate: 등록 시작일자; String; N; yyyy-mm-dd
ex) 2021-01-01

endDate: 등록 종료일자; String; N; yyyy-mm-dd
ex) 2021-01-01

출력결과(Response Element)

: 항목명(영문); 항목명(국문); 샘플데이터

JSON: result; pageNo; 페이지 번호; 1

: resultMessage; 처리메시지; "성공"

: resultState; 결과상태; "success"

: totalCount; 전체 자료수; 1000

: viewItemCnt; 배열길이; 10

: itemlist; mastrId; 자료고유ID; "2110000050"

: listSeCd; 목록구분코드; "2"

: listSeCdNm; 목록구분코드명; "도서(만화책)"

: prdctNm; 작품명; "샹치 : 사형제들"

: title; 서명; "샹치 : 사형제들"

: subtitl; 부제목; ""

: edtn; 에디션; ""

: pictrWritrNm; 그림작가; "다이크 루언, 필립 탄, 세바스티안 쳉 그림"

: sntncWritrNm; 글작가; "진 루엔 양 글"

: plscmpnIdNm; 출판사ID명; "(주)시공사"

: orginlTitle; 원작제목; ""

: originClCd; 출처분류코드; ""

: originClCdNm; 출처분류코드명; null

: stleClCd; 형태분류코드; ""

: stleClCdNm; 형태분류코드명; null

: mainGenreCd; 대표장르코드; "11"

: mainGenreCdNm; 대표장르코드명; "SF(공상과학)그래픽노벨"

: outline; 줄거리; "지도자 젱 주의 죽음 이후 모습을 드러내지 않았던 사악한 고대 비밀 집단..."

: isbn; ISBN; "9791165796648"

: issn; ISSN; ""

: setIsbn; SET ISBN; "9788952773524"

: pltfomCd; 플랫폼코드; null

: pltfomCdNm; 플랫폼코드명; null

: pltfomCmpnyIdNm; 플랫폼사ID명; ""

: ageGradCd; 연령등급코드; "1"

: ageGradCdNm; 연령등급코드명; "전체연령"

: pusryBeginDe; 연재개시일자; null

: pusryEndDe; 연재종료일자; null

: fnshYn; 완결여부; "N"

: pblcateYn; 출판여부; "Y"

: webtoonPusryYn; 웹투연재여부; "N"

: wnpzCareer; 수상경력; ""

: dstrcpIdNm; 유통사ID명; ""

: pblicteDe; 발행일자; "20210826"

: dtaTyCd; 자료유형코드; "01"

: dtaTyCdNm; 자료유형코드명; "단행본"

: orginlNationCd; 원작국가코드; "KOR"

: orginlNationCdNm; 원작국가코드명; "대한민국"

: relDe; 개봉일자; null

: tlviseBeginDe; 방영시작일자; null

: tlviseEndDe; 방영종료일자; null

: bdcpn; 방송사; null

: makr; 제작사; null

: distr; 배급사; null

: auspc; 주최; null

: mngt; 주관; null

: stndrd; 규격; "167*257"

: pgeCo; 페이지수; "120"

: wt; 무게; "334"

: prc; 가격; 13000

: eventSeCd; 행사구분코드; null

: eventSeCdNm; 행사구분코드명; null

: cnsleNm; 콘솔명; null

: imageDownloadUrl; 이지다운로드 URL; [URL주소]

요청변수(Request Parameter)

항목명(영문): 항목명(국문); 데이터형; 필수값; 기본값; 최대값; -

prvKey: 인증키값; String; Y; 승인 시 키값 발급

title: 도서제목; String; N

isbn: 국제 표준 도서 번호; String; N

pageNo: 현재 페이지번호; String; N; 0

viewItemCnt: 표시 항목 수; String; N; 10; 100

출력결과(Response Element)

: 항목명(영문); 항목명(국문); 샘플데이터

JSON: result; pageNo; 페이지 번호; 1

: resultMessage; 처리메시지; "성공"

: resultState; 결과상태; "success"

: totalCount; 전체 자료수; 162

: viewItemCnt; 배열길이; 10

: itemlist; title; 서명; "원피스 104"

: pessOfficNm; 도서관 소장위치; "보존실"

: prdctNm; 작품명; "원피스"

: orginlTitle; 원작제목; null

: pictrWritrNm; 그림작가; "오다 에이이치로"

: sntncWritrNm; 글작가; "오다 에이이치로"

: mainGenreCdNm; 대표장르명; "소년"

: isbn; ISBN; "9791169791526"

: setIsbn; SET ISBN; "9788984423206"

: callno; 청구기호; "C-111.13-오다에이ㅇ-v.104"

: originClCdNm; 연령등급; "전체연령"

: imageDownloadUrl; 이지다운로드 URL; [URL주소]

요청변수(Request Parameter)

항목명(영문): 항목명(국문); 데이터형; 필수값; 기본값; 최대값; -

prvKey: 인증키값; String; Y; 승인 시 키값 발급

title: 도서제목; String; N

isbn: 국제 표준 도서 번호; String; N

pictrWritrNm: 그림작가; String; N

sntncWritrNm: 글작가; String; N

pltfomCdNm: 플랫폼명; String; N

plscmpnIdNm: 출판사명; String; N

pageNo: 현재 페이지번호; String; N; 0

viewItemCnt: 표시 항목 수; String; N; 10; 100

출력결과(Response Element)

: 항목명(영문); 항목명(국문); 샘플데이터

JSON: result; pageNo; 페이지 번호; 1

: resultMessage; 처리메시지; "성공"

: resultState; 결과상태; "success"

: totalCount; 전체 자료수; 162

: viewItemCnt; 배열길이; 10

: itemlist; prdctNm; 작품명; "원피스"

: title; 서명; "원피스 학원 3"

: subtitl; 부제목; "천재 학생회장"

: edtn; 에디션; null

: pictrWritrNm; 그림작가; "코지 쇼헤이"

: sntncWritrNm; 글작가; "오다 에이이치로"

: mainGenreCdNm; 원작제목; "액션"

: mainGenreCdNm; 대표장르명; "소년"

: outline; 줄거리; 《ONE PIECE》 스핀오프 학원 코미디!! 루피 일행이 선사하는... "

: isbn; ISBN; "9791169798488"

: setIsbn; SET ISBN; "9791169444132"

: plscmpnIdNm; 출판사명; "대원씨아이"

: pltfomCdNm; 플랫폼명; null

: ageGradCdNm; 연령등급; "전체연령"

: imageDownloadUrl; 이지다운로드 URL; [URL주소]

신청 서비스 안내

제공기관: 한국만화영상진흥원
서비스유형: REST

심의여부: 심의 후 승인
활용기간: 승인일로부터 12개월 간 활용가능

OPEN API 신청서 작성 및 인증키 발급

사용자 유형 선택: 개인 기관

신청사유: 신청사유

활용목적: 활용목적

활용내용: 활용내용

시스템 유형: 일반

데이터 유형: JSON

회원에게만 제공되는 서비스 입니다. 로그인 하기