오픈 API 사용가이드-문화지식-문화포털

메뉴펼쳐보기

홈 문화지식문화오픈 API

문화오픈 API

sns 공유

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

요청서비스

한국의 문양정보조회서비스-2D개별문양 목록을 조회

요청URL

http://175.125.91.94/openapi/service/rest/pattern/docMeta

요청변수

요청변수 목록표이며 요청변수, 데이터타입, 필수, 길이, 설명 정보제공
요청변수	데이터타입	필수	길이	설명
from	String	O	8	시작기간(예:20101118)
to	String	O	8	종료기간(예:20101217)
cPage	String	O	10	현재페이지
rows	String	O	3	페이지당 ROW수
place	String	X	50	장소
gpsxfrom	String	X	11	경도 범위검색 중 하한
gpsyfrom	String	X	11	위도 범위검색 중 하한
gpsxto	String	X	11	경도 범위검색 중 상한
gpsyto	String	X	11	위도 범위검색 중 상한
keyword	String	X	20	검색값
sortStdr	String	X	1	1:등록일, 2:공연명, 3:지역

샘플URL

2010년 11월 18일부터 2010년 12월 17일 사이에 등록된 공연전시정보를 검색요청
http://www.culture.go.kr/openapi/rest/publicperformancedisplays/period?from=20101118&to=20101217&cPage=1&rows=10&place=&gpsxfrom=&gpsyfrom=&gpsxto=&gpsyto=&keyword=&sortStdr=1

출력결과 필드

출력결과 필드 목록표이며 필드, 데이터타입, 설명 정보제공
필드	데이터타입	설명
totalCount	String	전체count
from	String	요청파라미터-시작기간
to	String	요청파라미터-종료기간
cPage	String	요청파라미터-현재페이지
rows	String	요청파라미터-페이지당ROW수
place	String	요청파라미터-장소
gpsxfrom	String	요청파라미터-경도 범위검색 중 하한
gpsyfrom	String	요청파라미터-위도 범위검색 중 하한
gpsxto	String	요청파라미터-경도 범위검색 중 상한
gpsyto	String	요청파라미터-위도 범위검색 중 상한
keyword	String	요청파라미터-검색키워드
perforList	String	공연전시정보목록
seq	String	일련번호
title	String	제목
startDate	String	시작일
endDate	String	마감일
place	String	장소
realmName	String	분류명
area	String	지역
thumbnail	String	썸네일
gpsX	String	GPS-X좌표
gpsY	String	GPS-Y좌표

응답결과 예시

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<response>
  <comMsgHeader>
    <RequestMsgID />
    <ResponseTime>2010-12-08 13:21:10.2110</ResponseTime>
    <ResponseMsgID />
    <SuccessYN>Y</SuccessYN>
    <ReturnCode>00</ReturnCode>
    <ErrMsg>NORMAL SERVICE.</ErrMsg>
  </comMsgHeader>
  <msgBody>
    <totalCount>68</totalCount>
    <cPage>1</cPage>
    <rows>10</rows>
    <from>20101118</from>
    <to>20101217</to>
    <place />
    <gpsxfrom />
    <gpsyfrom />
    <gpsxto />
    <gpsyto />
    <keyword />
    <sortStdr>1</sortStdr>
    <perforList>
      <seq>32514</seq>
      <title>서울시국악관현악단 제308회 정기연주회 '성탄음악회'</title>
      <startDate>20101216</startDate>
      <endDate>20101216</endDate>
      <place>세종 M씨어터</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sejongpac.or.kr/upload/sjw/performance/20101117_89698298.jpg</thumbnail>
      <gpsX>126.9760607</gpsX>
      <gpsY>37.5721842</gpsY>
    </perforList>
    <perforList>
      <seq>34736</seq>
      <title>[아름다운목요일] 2000 2010 금호아트홀 Highlight   2010 금호아트홀 체임버 뮤직 소사이어티 4 : Brahms Essentials(III)</title>
      <startDate>20101216</startDate>
      <endDate>20101216</endDate>
      <place>금호아트홀</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.kumhoarthall.com/upload/PerfWeb/20100209/20100209_161_227홈페이지_CMS3.JPG</thumbnail>
      <gpsX>126.9738208</gpsX>
      <gpsY>37.5700171</gpsY>
    </perforList>
    <perforList>
      <seq>34717</seq>
      <title>볼쇼이 극장 오페라 갈라 콘서트</title>
      <startDate>20101216</startDate>
      <endDate>20101216</endDate>
      <place>예술의전당</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sac.or.kr//web/db1/new/image/101/prog_15720_1.jpg</thumbnail>
      <gpsX>127.015233</gpsX>
      <gpsY>37.4810478</gpsY>
    </perforList>
    <perforList>
      <seq>34672</seq>
      <title>크리스마스 캐롤   부산</title>
      <startDate>20101216</startDate>
      <endDate>20101217</endDate>
      <place>부산시민회관</place>
      <realmName>뮤지컬</realmName>
      <area>부산</area>
      <thumbnail>http://ticketimage.interpark.com/PlayDictionary/DATA/PlayDic/PlayDicUpload/040001/10/10/0400011010_19064_01.gif</thumbnail>
      <gpsX>129.0651425</gpsX>
      <gpsY>35.1388387</gpsY>
    </perforList>
    <perforList>
      <seq>34694</seq>
      <title>국립합창단 제134회 정기연주회 헨델의 오라토리아 <메시아></title>
      <startDate>20101215</startDate>
      <endDate>20101215</endDate>
      <place>예술의전당</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sac.or.kr/web/db1/new/image/101/prog_14354_1.jpg</thumbnail>
      <gpsX>127.015233</gpsX>
      <gpsY>37.4810478</gpsY>
    </perforList>
    <perforList>
      <seq>34715</seq>
      <title>김창호 콘트라베이스 독주회</title>
      <startDate>20101214</startDate>
      <endDate>20101214</endDate>
      <place>예술의전당</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sac.or.kr/web/db1/new/image/101/prog_15780_1.jpg</thumbnail>
      <gpsX>127.015233</gpsX>
      <gpsY>37.4810478</gpsY>
    </perforList>
    <perforList>
      <seq>34716</seq>
      <title>제46회 강남심포니오케스트라 정기연주회</title>
      <startDate>20101212</startDate>
      <endDate>20101212</endDate>
      <place>예술의전당</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sac.or.kr/lab2010/gangnam46/gangnam46.jpg</thumbnail>
      <gpsX>127.015233</gpsX>
      <gpsY>37.4810478</gpsY>
    </perforList>
    <perforList>
      <seq>32511</seq>
      <title>로맨틱 콘서트</title>
      <startDate>20101211</startDate>
      <endDate>20101211</endDate>
      <place>세종 M씨어터</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sejongpac.or.kr/upload/sjw/performance/20101111_48964791.jpg</thumbnail>
      <gpsX>126.9760607</gpsX>
      <gpsY>37.5721842</gpsY>
    </perforList>
    <perforList>
      <seq>34729</seq>
      <title>2010 개그패밀리 콘서트 시즌2</title>
      <startDate>20101211</startDate>
      <endDate>20101211</endDate>
      <place>경기도문화의전당</place>
      <realmName>연극</realmName>
      <area>경기</area>
      <thumbnail>http://www.ggac.or.kr/upload/play/5693/20101117101044610.jpg</thumbnail>
      <gpsX>127.0378053</gpsX>
      <gpsY>37.2630715</gpsY>
    </perforList>
    <perforList>
      <seq>34703</seq>
      <title>율 쳄버 콰이어 & 오케스트라 제 17회 정기 연주회</title>
      <startDate>20101211</startDate>
      <endDate>20101211</endDate>
      <place>예술의전당</place>
      <realmName>음악</realmName>
      <area>서울</area>
      <thumbnail>http://www.sac.or.kr/web/db1/new/image/101/prog_14851_1.jpg</thumbnail>
      <gpsX>127.015233</gpsX>
      <gpsY>37.4810478</gpsY>
    </perforList>
  </msgBody>
</response>

비고/에러 메시지

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<response>
  <comMsgHeader>
    <RequestMsgID />
    <ResponseTime>2010 12 08 13:12:52.1252</ResponseTime>
    <ResponseMsgID />
    <SuccessYN>N</SuccessYN>
    <ReturnCode>30</ReturnCode>
    <ErrMsg>SERVICE KEY IS NOT REGISTERED ERROR.</ErrMsg>
  </comMsgHeader>
</response>