문화포털API
문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 오픈 API를 통해 자유롭게 이용할 수 있도록 제공합니다
-
문화포털
오픈 API 정의문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 오픈 API를 통해 자유롭게 이용할 수 있도록 제공합니다.
-
문화포털
오픈 API 사용안내기본적으로 제공 API 서비스를 사용하시기 위하여 ‘서비스 인증키’ 를 개별적으로 발급받으셔야 합니다. 발급기관은 아래와 같습니다.
공공데이터포털 http://www.data.go.kr -
오픈API
<URL> 조합 예시요청URL + 검색조건 값(파라미터) + Service Key (Service Key에 대한 부분은 UTF-8로 URL 인코딩하여 보내야 함)
https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/period?from=20101118&to=20101217&cPage=1&rows=10&place=&gpsxfrom=&gpsyfrom=&gpsxto=&gpsyto=&keyword=&sortStdr=1&serviceKey={서비스 키}※ 자세한 사항은 각 조회서비스별 개발가이드를 참고하시기 바랍니다.
한눈에보는문화정보
조회서비스
조회서비스
한눈에보는문화정보 조회서비스는 공연전시정보에 대한 검색 결과를 외부에 REST 방식으로 전달하는 API서비스이다.
오퍼레이션 목록
오퍼레이션 | 서비스 내용 | 전송방식 | 요청URL |
---|---|---|---|
기간별공연 문화정보목록조회 | 기간별 문화정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/period |
지역별공연 문화정보목록조회 | 지역별 문화정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/area |
분야별공연 문화정보목록조회 | 분야별 문화정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest//publicperformancedisplays/realm |
문화정보 상세정보조회 | 문화정보 상세정보를 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/detail?seq={공연/전시일련번호} |
문화캘린더정보 목록조회 | 문화캘린더정보정보 목록 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/livelihood |
개발가이드 다운로드
한눈에보는문화정보 조회서비스 https://www.culture.go.kr/guide/docs/new_ppds_guide.zip에러메시지
- 1 : APPLICATION ERROR (어플리케이션 에러)
- 4 : HTTP_ERROR (HTTP 에러)
- 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
- 20 : SERVICE_ACCESS_DENIED_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 (등록되지 않은 IP)
- 99 : UNKNOWN_ERROR (기타에러)
문화시설
조회서비스
조회서비스
문화시설 조회서비스는 문화시설에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.
오퍼레이션 목록
오퍼레이션 | 서비스 내용 | 전송방식 | 요청URL |
---|---|---|---|
공연장정보 목록조회 | 공연장정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/cultureartspaces/performingplace |
미술관정보 목록조회 | 미술관정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/cultureartspaces/museum |
박물관정보 목록조회 | 박물관정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/publicperformancedisplays/realm |
문화/복지 시군구회관 정보목록조회 |
문화/복지 시군구회관정보 목록을 조회한다. |
REST | https://apis.data.go.kr/B553457/nopenapi/rest/cultureartspaces/hall |
도서관정보 목록조회 | 도서관정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/cultureartspaces/library |
문화예술 공간정보 상세정보조회 |
문화예술 공간정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/cultureartspaces/detail?seq={공간번호} |
개발가이드 다운로드
문화시설 조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/new_cass_guide.zip에러메시지
- 1 : APPLICATION ERROR (어플리케이션 에러)
- 4 : HTTP_ERROR (HTTP 에러)
- 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
- 20 : SERVICE_ACCESS_DENIED_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 (등록되지 않은 IP)
- 99 : UNKNOWN_ERROR (기타에러)
문화릴레이티켓할인 조회서비스
문화릴레이티켓할인 조회서비스는 문화릴레이티켓할인정보에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.
오퍼레이션 목록
오퍼레이션 | 서비스 내용 | 전송방식 | 요청URL |
---|---|---|---|
릴레이티켓할인서비스 목록조회 | 한국문화정보원에서 제공하는 문화릴레이티켓의 할인정보및 공연의 정보 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/ticketdiscounts/list |
릴레이티켓할인서비스 상세정보조회 | 문화릴레이티켓할인서비스의 공연의 상세 정보를 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/ticketdiscounts/detail |
개발가이드 다운로드
문화릴레이티켓할인 조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/new_gtds_guide.zip에러메시지
- 1 : APPLICATION ERROR (어플리케이션 에러)
- 4 : HTTP_ERROR (HTTP 에러)
- 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
- 20 : SERVICE_ACCESS_DENIED_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 (등록되지 않은 IP)
- 99 : UNKNOWN_ERROR (기타에러)
전통문양 조회서비스
전통문양 조회서비스는 전통문양에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.
오퍼레이션 목록
오퍼레이션 | 서비스 내용 | 전송방식 | 요청URL |
---|---|---|---|
2D개별문양 목록조회 | 2D개별문양 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/individualizations/2d |
3D개별문양 목록조회 | 3D개별문양 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/individualizations/3d |
개별문양 상세정보조회 | 개별문양 상세정보를 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/individualizations/detail?did={개별문양번호} |
원시문양 목록조회 | 원시문양 목록을 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/raws |
원시문양 상세정보조회 | 원시문양 상세정보를 조회한다. | REST | https://apis.data.go.kr/B553457/nopenapi/rest/koreanpattern/raws/detail?did={원시문양번호} |
개발가이드 다운로드
전통문양 조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/new_kps_guide.zip에러메시지
- 1 : APPLICATION ERROR (어플리케이션 에러)
- 4 : HTTP_ERROR (HTTP 에러)
- 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
- 20 : SERVICE_ACCESS_DENIED_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 (등록되지 않은 IP)
- 99 : UNKNOWN_ERROR (기타에러)