주메뉴 바로가기 본문 바로가기

문화포털

문화알리미 문화포털 API

문화포털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
    지역별공연 전시목록조회 지역별공연/전시 목록을 조회한다. 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
문화홍보
등록