본문 바로가기 푸터 바로가기
> 문화알리미 문화포털API

문화포털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. 1 : APPLICATION ERROR (어플리케이션 에러)
  2. 4 : HTTP_ERROR (HTTP 에러)
  3. 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
  4. 20 : SERVICE_ACCESS_DENIED_ERROR (서비스 접근거부)
  5. 22 : LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR (서비스 요청제한횟수 초과에러)
  6. 30 : SERVICE_KEY_IS_NOT_REGISTERED_ERROR (등록되지 않은 서비스키)
  7. 31 : DEADLINE_HAS_EXPIRED_ERROR (활용기간 만료)
  8. 32 : UNREGISTERED_IP_ERROR (등록되지 않은 IP)
  9. 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. 1 : APPLICATION ERROR (어플리케이션 에러)
  2. 4 : HTTP_ERROR (HTTP 에러)
  3. 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
  4. 20 : SERVICE_ACCESS_DENIED_ERROR (서비스 접근거부)
  5. 22 : LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR (서비스 요청제한횟수 초과에러)
  6. 30 : SERVICE_KEY_IS_NOT_REGISTERED_ERROR (등록되지 않은 서비스키)
  7. 31 : DEADLINE_HAS_EXPIRED_ERROR (활용기간 만료)
  8. 32 : UNREGISTERED_IP_ERROR (등록되지 않은 IP)
  9. 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. 1 : APPLICATION ERROR (어플리케이션 에러)
  2. 4 : HTTP_ERROR (HTTP 에러)
  3. 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
  4. 20 : SERVICE_ACCESS_DENIED_ERROR (서비스 접근거부)
  5. 22 : LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR (서비스 요청제한횟수 초과에러)
  6. 30 : SERVICE_KEY_IS_NOT_REGISTERED_ERROR (등록되지 않은 서비스키)
  7. 31 : DEADLINE_HAS_EXPIRED_ERROR (활용기간 만료)
  8. 32 : UNREGISTERED_IP_ERROR (등록되지 않은 IP)
  9. 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. 1 : APPLICATION ERROR (어플리케이션 에러)
  2. 4 : HTTP_ERROR (HTTP 에러)
  3. 12 : NO_OPENAPI_SERVICE_ERROR (해당 오픈 API 서비스가 없거나 폐기됨)
  4. 20 : SERVICE_ACCESS_DENIED_ERROR (서비스 접근거부)
  5. 22 : LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR (서비스 요청제한횟수 초과에러)
  6. 30 : SERVICE_KEY_IS_NOT_REGISTERED_ERROR (등록되지 않은 서비스키)
  7. 31 : DEADLINE_HAS_EXPIRED_ERROR (활용기간 만료)
  8. 32 : UNREGISTERED_IP_ERROR (등록되지 않은 IP)
  9. 99 : UNKNOWN_ERROR (기타에러)