본문 바로가기 푸터 바로가기
메인

문화포털API

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

문화포털 open api 서비스 안내

OPEN API 서비스를
아래와 같이 변경하였습니다.

신규 서비스 이용 부탁드립니다.

error_outline 2025. 4. 7(월)부터 (구)서비스는 중단 될 예정입니다.

task_alt 서비스 명칭 변경 및 현행화

auto_delete (구) 서비스

  • 한국문화정보원_한국의문양조회서비스
  • 한국문화정보원_티켓할인조회서비스
  • 한국문화정보원_문화예술공간조회서비스

add_reaction 신규서비스

  • 한국문화정보원_전통문양조회서비스
  • 한국문화정보원_문화릴레이티켓할인조회서비스
  • 한국문화정보원_문화시설조회서비스

task_alt 서비스 통합 및 현행화

auto_delete (구) 서비스

  • 한국문화정보원_공연전시정보조회서비스
  • 한국문화정보원_문화정보조회서비스

add_reaction 신규서비스

  • 한국문화정보원_한눈에보는문화정보조회서비스
  • 요청서비스

    전통문양 조회서비스-2D개별문양 목록을 조회

  • 요청URL
  • 요청변수
    오퍼레이션 목록
    요청변수 데이터타입 필수 설명
    serviceKey String O 공공데이터포털에서 받은 인증키
    PageNo String O 페이지번호
    numOfrows String O 한 페이지 결과 수
    shapeRealm String X 형태별문양분류명
    useRealm String X 용도별문양분류명
  • 샘플URL
  • 출력결과 필드
    오퍼레이션 목록
    요청변수 데이터타입 설명
    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>