만화규장각 로고

전체메뉴열기

OPEN API

OPEN API 소개
OPEN API 사용방법
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
Y
isbn
국제 표준 도서 번호
String
Y
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 신청서 작성 및 인증키 발급

사용자 유형 선택
신청사유
활용목적
활용내용
시스템 유형
데이터 유형
회원에게만 제공되는 서비스 입니다. 로그인 하기