오픈API 사용예제 - 문화포털API

홈 메인

문화포털API

문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 오픈 API를 통해 자유롭게 이용할 수 있도록 제공합니다

요청서비스

전통문양 조회서비스-2D개별문양 목록을 조회
요청URL
https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/individualizations/2d

요청변수

오퍼레이션 목록
요청변수	데이터타입	필수	설명
serviceKey	String	O	공공데이터포털에서 받은 인증키
PageNo	String	O	페이지번호
numOfrows	String	O	한 페이지 결과 수
shapeRealm	String	X	형태별문양분류명
useRealm	String	X	용도별문양분류명

샘플URL

검색키워드가 청화백자꽃문항아리를 포함한 전통문양정보를 검색요청
https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/individualizations/2d?serviceKey={발급서비스키}&PageNo=1&numOfrows=10&keyword=%EC%B2%AD%ED%99%94%EB%B0%B1%EC%9E%90%EA%BD%83%EB%AC%B8%ED%95%AD%EC%95%84%EB%A6%AC

출력결과 필드

오퍼레이션 목록
요청변수	데이터타입	설명
totalCount	String	전체count
PageNo	String	요청파라미터-페이지번호
numOfrows	String	요청파라미터-한페이지 결과수
did	String	문양아이디
title	String	문양명
thumbnail	String	썸네일이미지

응답결과 예시

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
	<header>
		<reseultCode>00</reseultCode>
		<resultMsg>정상입니다.</resultMsg>
	</header>
	<body>
		<totalCount>1</totalCount>
		<PageNo>1</PageNo>
		<numOfrows>10</numOfrows>
		<items>
			<item>
				<did>100264</did>
				<title>청화백자꽃문항아리</title>
				<thumbnail>https://www.culture.go.kr/ptn/images/ut/6e/ut6eflmsma8v83tya23iawjx84022xa7.png</thumbnail>
			</item>
		</items>
	</body>
</response>

비고/에러 메시지

<OpenAPI ServiceResponse>
	<cmmMsgHeader>
		<errMsg>SERVICE ERROR</errMsg>
		<returnAuthMsg>SERVICE_KEY_IS_NOT_REGISTERED_ERROR</returnAuthMsg>
		<returnReasonCode>30</returnReasonCode>
  	</cmmMsgHeader>
<OpenAPI ServiceResponse>