문화포털

    문화포털
    회원가입
    암표신고 문화홍보등록

      인기검색어

        홈 누려요 문화혜택 문화포털API 오픈 API 사용가이드

        오픈 API 사용가이드

        OPEN API 사용가이드선택됨 OPEN API 사용예제
        • 문화포털
          오픈 API 사용안내

          기본적으로 제공 API 서비스를 사용하시기 위하여 ‘서비스 인증키’ 를 개별적으로 발급받으셔야 합니다. 발급기관은 아래와 같습니다.

          공공데이터포털 http://www.data.go.kr

          • 공공데이터포털
            로그인

          • 원하는 API서비스
            검색

          • API 서비스
            ‘활용신청‘ 클릭

          • 신청 정보
            입력

          • 마이페이지에서
            인증키 확인 및 활용

        • 오픈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 (해당 OPEN 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 (해당 OPEN 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 (해당 OPEN 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 (해당 OPEN 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 (기타에러)

        관련기관 안내

        close