문화포털API
문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 오픈 API를 통해 자유롭게 이용할 수 있도록 제공합니다.
문화포털 오픈 API 정의
문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 오픈 API를 통해 자유롭게 이용할 수 있도록 제공합니다.
문화포털 오픈 API 사용안내
기본적으로 제공 API 서비스를 사용하시기 위하여 ‘서비스 인증키’ 를 개별적으로 발급받으셔야 합니다. 발급기관은 아래와 같습니다.
공공데이터포털 http://www.data.go.kr
오픈API <URL> 조합 예시
요청URL + 검색조건 값(파라미터) + Service Key (Service Key에 대한 부분은 UTF-8로 URL 인코딩하여 보내야 함)
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&serviceKey={서비스 키}
자세한 사항은 각 조회서비스별 개발가이드를 참고하시기 바랍니다.
공연전시 정보 조회서비스
공연전시정보조회서비스는 공연전시정보에 대한 검색 결과를 외부에 REST 방식으로 전달하는 API서비스이다.
-
오퍼레이션 목록
오퍼레이션, 서비스 내용, 전송방식, 요청 URL 항목으로 구성된 오퍼레이션 목록 표 오퍼레이션 서비스 내용 전송방식 요청 URL 기간별공연 전시목록조회 기간별공연/전시 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/publicperformancedisplays/period 지역별공연 전시목록조회 지역별공연/전시 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/publicperformancedisplays/area 분야별공연 전시목록조회 분야별공연/전시 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/publicperformancedisplays/realm 공연/전시 상세정보조회 공연/전시 상세정보를 조회한다. REST http://www.culture.go.kr/openapi/rest/publicperformancedisplays/d/?seq={공연/전시번호} -
개발가이드 다운로드
공연전시정보조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/ppds_guide.zip
-
에러메시지
- 00 : NORMAL SERVICE
- 01 : APPLICATION ERROR
- 02 : DB_ERROR
- 03 : NODATA ERROR
- 04 : HTTP ERROR
- 05 : SERVICETIMEOUT ERROR
- 10 : INVALID REQUEST PARAMETER ERROR
- 11 : MANDATORY REQUEST PARAMETERS ERROR
- 12 : NO OPENAPI SERVICE ERROR
- 20 : SERVICE ACCESS DENIED ERROR
- 21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
- 22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
- 30 : SERVICE KEY IS NOT REGISTERED ERROR
- 31 : DEADLINE HAS EXPIRED ERROR
- 32 : UNREGISTERED IP ERROR
- 33 : UNSIGNED CALL ERROR
- 99 : UNKNOWN ERROR
관련기관 안내
