인천문화재단

요청 URL

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

요청변수

문화예술단체 API 요청 변수 표 (항목명(영문), 항목명(국문), 항목크기, 항목구분, 샘플데이터, 항목설명 안내)
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
apiKey	API 키	32	1		API 인증키
svID	서비스 아이디	20	1	group	서비스 아이디
resultType	출력방식	4	1	json	검색결과 출력 방식(xml / json)
srh_cate	분야 코드	2	0	CA01	지역축제 분류 코드 표 참조
srh_title	단체명	100	0	단체명	단체명(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	단체명	100	1	단체명
link	뷰페이지 URL		1
category	분류	20	1	기타	분류코드표 참조
location	주소	255	0	인천광역시 서구
email	이메일	255	0	test@test.com
tel	연락처	255	0	032-440-3962
fax	팩스	255	0	032-000-0000
createYear	설립년도	10	0	2021
rprsntv	대표자	20	0	대표 홍길동
homepage	홈페이지	255	0	http://cruisestory.co.kr
poster	포스터 이미지 URL	255	0	http://iq.ifac.or.kr/upfiles/culture/2014/c2abc3d0f409b3dbb.jpg
description	기타정보	text	0	축제의 유래 및 특성 ㅇ세계로 나가는 청소년(Global Zone), 지구를 생각하는 청소년(Green Zone), 미래를 준비하는 청소년(Growth Zone) 등의 주제를 가진 축제. 개최장소 ㅇ삼산월드체육관 주경기장 주요행사 내용 ㅇ세계여행, 재활용품 리폼법, 별자리체험, 청소년진로상담 등 다양한 청소년체험부스 ㅇ영어스피치대회, 청소년문화예술경연대회 ㅇ미니체력장, 전통놀이, 영어퀴즈, 기초상식 최강전등, 입장권 빙고이벤트 관련 홈페이지 ㅇwww.incheon.go.kr/icweb/html/web1/001.html
majorWorks	주요작품	text	0	주요작품 내용
awards	수상경력	text	0	수상경력 내용
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?svID=group&apiKey=bB5YWGw2Av7r94DTm3ujRLzZ6kHgdy&resultType=xml&pSize=3&cPage=1

응답 메세지

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

<?xml version="1.0" encoding="utf-8" ?>
<iq>
    <resultCode><![CDATA[0000]]></resultCode>
    <resultMsg><![CDATA[정상 처리되었습니다.]]></resultMsg>
    <totalCnt><![CDATA[75]]></totalCnt>
    <item>
        <idx><![CDATA[131]]></idx>
        <title><![CDATA[단체명]]></title>
        <link><![CDATA[http://iq.ifac.or.kr/wellspring/group/view.do?key=m2102173971506&wellspringGroupSn=131]]></link>
        <category><![CDATA[기타]]></category>
        <location><![CDATA[인천광역시 서구]]></location>
        <email><![CDATA[test@test.com]]></email>
        <tel><![CDATA[032-440-3962]]></tel>
        <fax><![CDATA[032-0000-0000]]></fax>
        <homepage><![CDATA[iq.ifac.or.kr]]></homepage>
        <createYear><![CDATA[2021]]></createYear>
        <rprsntv><![CDATA[홍길동]]></rprsntv>
        <poster><![CDATA[]]></poster>
        <description><![CDATA[축제의 유래 및 특성
ㅇ세계로 나가는 청소년(Global Zone), 지구를 생각하는 청소년(Green Zone), 미래를 준비하는 청소년(Growth Zone) 등의 주제를 가진 축제.

개최장소
ㅇ삼산월드체육관 주경기장

주요행사 내용
ㅇ세계여행, 재활용품 리폼법, 별자리체험, 청소년진로상담 등 다양한 청소년체험부스
ㅇ영어스피치대회, 청소년문화예술경연대회
ㅇ미니체력장, 전통놀이, 영어퀴즈, 기초상식 최강전등, 입장권 빙고이벤트

관련 홈페이지
ㅇwww.incheon.go.kr/icweb/html/web1/001.html]]></description>
        <majorWorks><![CDATA[주요 작품 활동]]></majorWorks>
        <awards><![CDATA[수상이력 내용]]></awards>
        <pubDate><![CDATA[2010-06-25 04:41:57]]></pubDate>
    </item>
</iq>

참고 코드 표

분류 코드

문화예술단체 API 문화예술단체 분류 참고 코드 표(코드, 분야 안내)
코드	분야
CA01	문학•예술
CA02	시각예술
CA03	공연예술
CA04	문화일반
CA05	기타

결과코드

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

OPEN API

공유하기