본문 내용 바로가기

API둘러보기API 가이드 문화행사

인천문화예술정보 사이트에 등록되어 있는 행사정보를 제공합니다. 목록

요청 URL

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

요청 변수

요청 변수 정의 테이블
항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
apiKey API 키 32 1 API 인증키
svID 서비스 아이디 20 1 culture 서비스 아이디
resultType 출력방식 4 1 json 검색결과 출력 방식(xml / json)
srh_periodType 행사일정 검색방식 1 0 d d:일일검색, p:기간검색
srh_sDate 행사시작일 8 0 20140922 int 형식
srh_eDate 행사종료일 8 0 20140922 int 형식
srh_cate 분야 코드 30 0..n 1,3,4 행사분야 코드 표 참조
※ 여러분야일 경우 콤마로 나열
srh_feeCase 관람료 유형 1 0 P p:유료, f:무료
srh_placeCode 지역 코드 30 0..n 1,3 행사지역 코드표 참조
※ 여러지역일 경우 콤마로 나열
srh_title 행사명 1000 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)

응답 결과

응답 결과 안내 테이블
항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
resultCode 결과코드 4 1 0 결과코드 표 참조
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가)
place_sido 행사장소-시도 32 1 인천광역시
place_gugun 행사장소-구군 8 0
management 주최/주관 100 1 크루즈스토리
fee_case 관람료 유형 10 1 유료 유료 / 무료 / 기타
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 <음악불꽃크루즈>는 매주 다른 테마로 진행이 되는 선상불꽃축제이다
reserve_info 예매정보 text 0 조기예매 5천원 할인 (기간 : 8월 4일 ~ 22일)
reserve_URL 예매 URL 255 0 http://ticket.interpark.com/Ticket/Goods/GoodsInfo.asp?GoodsCode=14008278
pubDate 등록일 dateimte 1 2014-08-27 7:06

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

요청/응답 메세지 예제

- 요청 URL

http://iq.ifac.or.kr/openAPI/real/search.php?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/culture_view.php?no=2559]]></link>
		<category><![CDATA[축제/문화행사]]></category>
		<sdate><![CDATA[20140912]]></sdate>
		<edate><![CDATA[20140918]]></edate>
		<place><![CDATA[서초구 남부순환로 2406 (서초동)]]></place>
		<place_sido><![CDATA[서울특별시]]></place_sido>
		<place_gugun><![CDATA[]]></place_gugun>
		<management><![CDATA[대한민국 국제관악제 추진위원회]]></management>
		<fee_case><![CDATA[유료]]></fee_case>
		<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>
		<reserve_info><![CDATA[]]></reserve_info>
		<reserve_URL><![CDATA[]]></reserve_URL>
		<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/culture_view.php?no=2591]]></link>
		<category><![CDATA[음악/콘서트]]></category>
		<sdate><![CDATA[20140918]]></sdate>
		<edate><![CDATA[20140918]]></edate>
		<place><![CDATA[인천종합문화예술회관]]></place>
		<place_sido><![CDATA[인천광역시]]></place_sido>
		<place_gugun><![CDATA[남동구]]></place_gugun>
		<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>
		<reserve_info><![CDATA[]]></reserve_info>
		<reserve_URL><![CDATA[]]></reserve_URL>
		<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/culture_view.php?no=2590]]></link>
		<category><![CDATA[음악/콘서트]]></category>
		<sdate><![CDATA[20140919]]></sdate>
		<edate><![CDATA[20140919]]></edate>
		<place><![CDATA[인천종합문화예술회관]]></place>
		<place_sido><![CDATA[인천광역시]]></place_sido>
		<place_gugun><![CDATA[남동구]]></place_gugun>
		<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>
		<reserve_info><![CDATA[모든 예매처 티켓 매진되었습니다.]]></reserve_info>
		<reserve_URL><![CDATA[]]></reserve_URL>
		<pubDate><![CDATA[2014-08-30 04:37:52]]></pubDate>
	</item>
</iq>
					

참고 코드 표

  • - 행사 분야별 코드
    행사 분야별 코드
    코드 분야
    1 무용
    2 문학/인문학
    3 교육/체험
    4 뮤지컬/오페라
    5 아동극/인형극
    6 연극
    7 음악/콘서트
    8 전시
    9 전통예술
    10 축제/문화행사
    11 기타
    12 영화
    13 토크콘서트
    14 포럼/세미나
    15 스포츠/레저
  • - 행사 지역별 코드
    행사 분야별 코드
    코드 지역
    1 인천광역시 부평구
    2 인천광역시 동구
    3 인천광역시 강화군
    4 인천광역시 계양구
    5 인천광역시 중구
    6 인천광역시 남동구
    7 인천광역시 미추홀구
    8 인천광역시 옹진군
    9 인천광역시 서구
    10 인천광역시 연수구
    11 경기도 김포
    12 경기도 부천
    13 경기도 시흥

결과코드

응답 결과 안내 테이블
코드 메시지
0 정상 처리되었습니다.
1 전송데이터(호출 파라미터) 오류입니다.
2 등록되지 않은 API Key 입니다.
3 승인 대기중인 API Key 입니다.
4 사용이 일시중지중인 API Key 입니다.
5 삭제된 API Key 입니다.
6 일일 허용 쿼리수를 초과하였습니다.
7 유효 데이터가 없습니다.
8 일시중지중인 서비스입니다.
9 중지된 서비스입니다.
10 유효하지 않는 서비스입니다.

목록