문화예술행사 API
요청 URL
- http://iq.ifac.or.kr/openAPI/real/search.do
요청 변수
문화예술행사 API 요청 변수
문화예술행사 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 응답결과
문화예술행사 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 지역축제 분류 참고 코드 표
문화예술행사 API 지역축제 분류 참고 코드 표로 코드, 분야를 안내합니다.
| 코드 |
분야 |
| CUL01 |
공연 |
| CUL02 |
전시 |
| CUL03 |
행사 |
| CUL04 |
교육/체험 |
| CUL05 |
세미나/포럼 |
| CUL06 |
영화 |
행사 지역별 코드
문화예술행사 API 행사 지역별 참고 코드 표
문화예술행사 API 행사 지역별 참고 코드 표로 코드, 지역을 안내합니다.
| 코드 |
지역 |
| 1 |
인천광역시 부평구 |
| 2 |
인천광역시 동구 |
| 3 |
인천광역시 강화군 |
| 4 |
인천광역시 계양구 |
| 5 |
인천광역시 중구 |
| 6 |
인천광역시 남동구 |
| 7 |
인천광역시 미추홀구 |
| 8 |
인천광역시 옹진군 |
| 9 |
인천광역시 서구 |
| 10 |
인천광역시 연수구 |
| 11 |
경기도 김포 |
| 12 |
경기도 부천 |
| 13 |
경기도 시흥 |
결과코드
문화예술행사 API 결과코드
문화예술행사 API 결과코드 표로 코드, 분야를 안내합니다.
| 코드 |
분야 |
| 0000 |
정상 처리되었습니다. |
| 0001 |
전송데이터(호출 파라미터) 오류입니다. |
| 0002 |
등록되지 않은 API Key 입니다. |
| 0003 |
승인 대기중인 API Key 입니다. |
| 0004 |
사용이 일시중지중인 API Key 입니다. |
| 0005 |
삭제된 API Key 입니다. |
| 0006 |
일일 허용 쿼리수를 초과하였습니다. |
| 0007 |
유효 데이터가 없습니다. |
| 0008 |
일시중지중인 서비스입니다. |
| 0009 |
중지된 서비스입니다. |
| 0010 |
유효하지 않는 서비스입니다. |
