인천문화재단

요청 URL

http://iq.ifac.or.kr/openAPI/real/search.do

요청변수

문화예술행사 API 요청 변수 표 (항목명(영문), 항목명(국문), 항목크기, 항목구분, 샘플데이터, 항목설명 안내)
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
apiKey	API 키	32	1		API 인증키
svID	서비스 아이디	20	1	culture	서비스 아이디
resultType	출력방식	4	1	json	검색결과 출력 방식(xml / json)
srh_sDate	행사시작일	8	0	20140922	int 형식
srh_eDate	행사종료일	8	0	20140922	int 형식
srh_cate	분야 코드	30	0..n	CUL01, CUL03	행사분야 코드 표 참조 ※ 여러분야일 경우 콤마로 나열
srh_feeCase	관람료 유형	1	0	p	p:유료, f:무료
srh_placeCode	지역 코드	30	0..n	1,3	행사지역 코드표 참조 ※ 여러지역일 경우 콤마로 나열
srh_title	행사명	100	0	%EC%9D%B8%EC%B2%9C(인천)	행사명 키워드(urlencode)
srh_place	행사장소	1000	0	%EC%98%88%EC%88%A0%ED%9A%8C%EA%B4%80(예술회관)	행사장소 키워드(urlencode)
pSize	아티클 수	3	0	15	페이지당 아티클 개수 (생략 시 기본 10)
cPage	페이지 번호	5	0	3	출력하고자 하는 페이지 번호 (생략 시 기본 1)

항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 결과

문화예술행사 API 응답결과 표 (항목명(영문), 항목명(국문), 항목크기, 항목구분, 샘플데이터, 항목설명 안내)
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
resultCode	결과코드	4	1	0000	결과코드 표 참조
resultMsg	결과메시지	100	1	정상 처리되었습니다.	결과메시지
errorMsg	오류메시지	100	0	10	실패인 경우 오류의 상세내용
totalCnt	전체 데이터 건수	10	1	1	조회데이터의 총건수
item	세부항목		0..n		세부 항목
idx	아티클 번호	11	1	1	지역축제의 고유 등록번호
title	행사명	200	1	선상불꽃축제 음악불꽃크루즈	행사명
link	뷰페이지 URL		1
category	분야	20	1	축제/문화행사	행사 분야
sdate	시작일(Ymd)	8	1	20140917	행사 시작일
edate	종료일(Ymd)	8	1	20140920	행사 종료일
place	행사시설명	100	1	중구 연안부두로 36 (항동7가)
placeSido	행사장소-시도	32	1	인천광역시
placeGugun	행사장소-구군	8	0
management	주최/주관	100	1	크루즈스토리
feeCase	관람료 유형	10	0	유료	유료 / 무료 / 기타
fee	상세 관람료	tinytext	0	30,000원
tel	문의처 전화번호	15	0	02-2603-8678
homepage	관련 홈페이지	255	1	http://cruisestory.co.kr
poster	포스터 이미지 URL	255	1	http://iq.ifac.or.kr/upfiles/culture/2014/c2abc3d0f409b3dbb.jpg
posterThumb	포스터 썸네일 이미지 URL	255	1	http://iq.ifac.or.kr/upfiles/culture/2014/thumb_c2abc3d0f409b3dbb.jpg
description	행사 상세설명	text	0	<음악불꽃크루즈>는 매주 다른 테마로 진행이 되는 선상불꽃축제이다
reserveInfo	예매정보	text	0	조기예매 5천원 할인 (기간 : 8월 4일 ~ 22일)
reserveURL	예매 URL	255	0	http://ticket.interpark.com/Ticket/Goods/GoodsInfo.asp?GoodsCode=14008278
pubDate	등록일	dateimte	1	2010-06-25 04:41:57

항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

요청/응답
메세지 예제

요청 URL

http://iq.ifac.or.kr/openAPI/real/search.do?apiKey=123456789a&svID=culture&resultType=xml&srh_periodType=p&srh_sDate=20140915&srh_eDate=20140920&pSize=3&cPage=2

응답 메세지

좌우로 스크롤 하시면 확인이 가능합니다.

<?xml version="1.0" encoding="utf-8" ?>
<iq>
    <resultCode><![CDATA[0000]]></resultCode>
    <resultMsg><![CDATA[정상 처리되었습니다.]]></resultMsg>
    <totalCnt><![CDATA[31]]></totalCnt>
    <item>
        <idx><![CDATA[2559]]></idx>
        <title><![CDATA[대한민국국제관악제]]></title>
        <link><![CDATA[http://iq.ifac.or.kr/culture/view.do?key=m2102173741239&eventSn=2559]]></link>
        <category><![CDATA[축제/문화행사]]></category>
        <sdate><![CDATA[20140912]]></sdate>
        <edate><![CDATA[20140918]]></edate>
        <place><![CDATA[서초구 남부순환로 2406 (서초동)]]></place>
        <placeSido><![CDATA[서울특별시]]></placeSido>
        <placeGugun><![CDATA[]]></placeGugun>
        <management><![CDATA[대한민국 국제관악제 추진위원회]]></management>
        <feeCase><![CDATA[유료]]></feeCase>
        <fee><![CDATA[공연별 유료]]></fee>
        <tel><![CDATA[02-516-1245]]></tel>
        <homepage><![CDATA[http://windband.or.kr]]></homepage>
        http://developer.naver.com/wiki/pages/News
        <poster><![CDATA[]]></poster>
        <posterThumb><![CDATA[http://iq.ifac.or.kr/upfiles/culture/2014/thumb_f4810ee722bfb8b09.JPG]]></posterThumb>
        <description><![CDATA[2014년 9월 12일부터 9월 18일까지 서울 예술의전당과 광화문광장, 올림픽 광장 등에서 <제5회 대한민국 국제관악제>가 개최된다. 관악으로 소통하며 하나 되는 국민적 축제로 관악으로 대한민국 국가 브랜드를 높이는 문화예술제이다.]]></description>
        <reserveInfo><![CDATA[]]></reserveInfo>
        <reserveURL><![CDATA[]]></reserveURL>
        <pubDate><![CDATA[2014-08-27 06:54:12]]></pubDate>
    </item>
    <item>
        <idx><![CDATA[2591]]></idx>
        <title><![CDATA[팝페라와 함께하는 아시안의 향기]]></title>
        <link><![CDATA[http://iq.ifac.or.kr/culture/view.do?key=m2102173741239&eventSn=2591]]></link>
        <category><![CDATA[음악/콘서트]]></category>
        <sdate><![CDATA[20140918]]></sdate>
        <edate><![CDATA[20140918]]></edate>
        <place><![CDATA[인천종합문화예술회관]]></place>
        <placeSido><![CDATA[인천광역시]]></placeSido>
        <placeGugun><![CDATA[남동구]]></placeGugun>
        <management><![CDATA[로멘틱 아르떼]]></management>
        <fee_case><![CDATA[무료]]></fee_case>
        <fee><![CDATA[무료]]></fee>
        <tel><![CDATA[032)511-6744]]></tel>
        <homepage><![CDATA[http://art.incheon.go.kr/app/reserveDay-5/6107]]></homepage>
        <poster><![CDATA[http://iq.ifac.or.kr/upfiles/culture/2014/675a128a5030fe7f0.jpg]]></poster>
        <posterThumb><![CDATA[http://iq.ifac.or.kr/upfiles/culture/2014/thumb_675a128a5030fe7f0.jpg]]><span class="tag"></posterThumb>
        <description><![CDATA[관람 시간 : 오후 7시
관람 장소 : 야외 공연장
관람 연령 : 제한 없음]]></description>
        <reserveInfo><![CDATA[]]></reserveInfo>
        <reserveURL><![CDATA[]]></reserveURL>
        <pubDate><![CDATA[2014-08-30 04:40:27]]></pubDate>
    </item>
    <item>
        <idx><![CDATA[2590]]></idx>
        <title><![CDATA[밴드데이Ⅸ. 가을방학]]></title>
        <link><![CDATA[http://iq.ifac.or.kr/culture/view.do?key=m2102173741239&eventSn=2590]]></link>
        <category><![CDATA[음악/콘서트]]></category>
        <sdate><![CDATA[20140919]]></sdate>
        <edate><![CDATA[20140919]]></edate>
        <place><![CDATA[인천종합문화예술회관]]></place>
        <placeSido><![CDATA[인천광역시]]></placeSido>
        <placeGugun><![CDATA[남동구]]></placeGugun>
        <management><![CDATA[인천종합문화예술회관]]></management>
        <fee_case><![CDATA[유료]]></fee_case>
        <fee><![CDATA[전석 2만원]]></fee>
        <tel><![CDATA[032-420-2736]]></tel>
        <homepage><![CDATA[http://art.incheon.go.kr/app/reserveDay-5/6089]]></homepage>
        <poster><![CDATA[http://iq.ifac.or.kr/upfiles/culture/2014/1213b35a88627c761.jpg]]></poster>
        <posterThumb><![CDATA[http://iq.ifac.or.kr/upfiles/culture/2014/thumb_1213b35a88627c761.jpg]]></posterThumb>
        <description><![CDATA[관람 시간 : 오후 8시
관람 장소 : 소공연장
관람 연령 : 중학생 이상]]></description>
        <reserveInfo><![CDATA[모든 예매처 티켓 매진되었습니다.]]></reserveInfo>
        <reserveURL><![CDATA[]]></reserveURL>
        <pubDate><![CDATA[2014-08-30 04:37:52]]></pubDate>
    </item>
</iq>

참고 코드 표

지역축제 분류 코드

문화예술행사 API 지역축제 분류 참고 코드 표 (코드, 분야 안내)
코드	분야
CUL01	공연
CUL02	전시
CUL03	행사
CUL04	교육/체험
CUL05	세미나/포럼
CUL06	영화

행사 지역별 코드

문화예술행사 API 행사 지역별 참고 코드 표 (코드, 지역 안내)
코드	지역
1	인천광역시 부평구
2	인천광역시 동구
3	인천광역시 강화군
4	인천광역시 계양구
5	인천광역시 중구
6	인천광역시 남동구
7	인천광역시 미추홀구
8	인천광역시 옹진군
9	인천광역시 서구
10	인천광역시 연수구
11	경기도 김포
12	경기도 부천
13	경기도 시흥

결과코드

문화예술행사 API 결과코드 표 (코드, 분야 안내)
코드	분야
0000	정상 처리되었습니다.
0001	전송데이터(호출 파라미터) 오류입니다.
0002	등록되지 않은 API Key 입니다.
0003	승인 대기중인 API Key 입니다.
0004	사용이 일시중지중인 API Key 입니다.
0005	삭제된 API Key 입니다.
0006	일일 허용 쿼리수를 초과하였습니다.
0007	유효 데이터가 없습니다.
0008	일시중지중인 서비스입니다.
0009	중지된 서비스입니다.
0010	유효하지 않는 서비스입니다.

OPEN API

공유하기