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

홈 > 문화알리미 문화포털API

문화포털API

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

요청서비스

한국의 문양정보조회서비스-2D개별문양 목록을 조회
요청URL
http://175.125.91.94/openapi/service/rest/pattern/docMeta

요청변수

오퍼레이션 목록
요청변수	데이터타입	필수	길이	설명
From	String	O	20	시작기간(예:20101118)
to	String	O	20	종료기간(예:20101217)
Cpage	String	O	20	현재페이지
rows	String	O	20	페이지당 ROW수
place	String	O	20	장소
gpsxfrom	String	O	20	경도 범위검색 중 하한
gpsyfrom	String	O	20	경도 범위검색 중 하한
gpsxto	String	O	20	경도 범위검색 중 하한
gpsxto	String	O	20	경도 범위검색 중 하한
keyword	String	O	20	검색값
sortStdr	String	O	20	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	요청파라미터-경도 범위검색 중 하한
gpsxfrom	String	요청파라미터-위도 범위검색 중 하한
gpsxto	String	요청파라미터-경도 범위검색 중 상한
gpsxto	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>
<sgBody>

비고/에러 메시지

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