상세 컨텐츠

본문 제목

[API 연동]일별 박스오피스 API 서비스 목록과 전문양식

IT/API

by 심장과영혼 2023. 1. 31. 22:29

본문

728x90
반응형
오늘은 영화 API에 대해서 알아보고자 합니다. 
영화API를 사용하여 실시간으로 영화와 관련정보들을 가져올 수 있습니다.

 

1. 일별 박스오피스 API 서비스
2. 주간/주말 박스오피스 API 서비스
3. 공통코드 조회 API 서비스
4. 영화목록 조회 API 서비스
5. 영화상세정보 조회 API 서비스
6. 영화사목록 조회 API 서비스
7. 영화사 상세정보 조회 API 서비스
8. 영화인목록 조회 API 서비스
9.영화인 상세정보 조회 API 서비스

 

 
 
 

1. 일별 박스오피스 API 서비스

 

특정 일자 상영작들의 박스오피스 정보를 영화구분(다양성영화,상업영화), 한국/외국 구분, 상영지역 등의 조건을 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
    요청 변수값설명
    key 문자열(필수) 발급받은키 값을 입력합니다.
    targetDt 문자열(필수) 조회하고자 하는 날짜를 yyyymmdd 형식으로 입력합니다.
    itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”, 최대 : “10“)
    multiMovieYn 문자열 다양성 영화/상업영화를 구분지어 조회할 수 있습니다.
    “Y” : 다양성 영화 “N” : 상업영화 (default : 전체)
    repNationCd 문자열 한국/외국 영화별로 조회할 수 있습니다.
    “K: : 한국영화 “F” : 외국영화 (default : 전체)
    wideAreaCd 문자열 상영지역별로 조회할 수 있으며, 지역코드는 공통코드 조회 서비스에서 “0105000000” 로서 조회된 지역코드입니다. (default : 전체)
  • 응답 구조
    응답 필드값설명
    boxofficeType 문자열 박스오피스 종류를 출력합니다.
    showRange 문자열 박스오피스 조회 일자를 출력합니다.
    rnum 문자열 순번을 출력합니다.
    rank 문자열 해당일자의 박스오피스 순위를 출력합니다.
    rankInten 문자열 전일대비 순위의 증감분을 출력합니다.
    rankOldAndNew 문자열 랭킹에 신규진입여부를 출력합니다.
    “OLD” : 기존 , “NEW” : 신규
    movieCd 문자열 영화의 대표코드를 출력합니다.
    movieNm 문자열 영화명(국문)을 출력합니다.
    openDt 문자열 영화의 개봉일을 출력합니다.
    salesAmt 문자열 해당일의 매출액을 출력합니다.
    salesShare 문자열 해당일자 상영작의 매출총액 대비 해당 영화의 매출비율을 출력합니다.
    salesInten 문자열 전일 대비 매출액 증감분을 출력합니다.
    salesChange 문자열 전일 대비 매출액 증감 비율을 출력합니다.
    salesAcc 문자열 누적매출액을 출력합니다.
    audiCnt 문자열 해당일의 관객수를 출력합니다.
    audiInten 문자열 전일 대비 관객수 증감분을 출력합니다.
    audiChange 문자열 전일 대비 관객수 증감 비율을 출력합니다.
    audiAcc 문자열 누적관객수를 출력합니다.
    scrnCnt 문자열 해당일자에 상영한 스크린수를 출력합니다.
    showCnt 문자열 해당일자에 상영된 횟수를 출력합니다.

 

 

2. 주간/주말 박스오피스 API 서비스

 

특정 일자가 속한 주차의 주간/주말/주중 상영작들의 박스오피스 정보를 영화구분(다양성영화,상업영화), 한국/외국 구분, 상영지역등의 조건을 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
    요청 변수값설명
    key 문자열(필수) 발급받은키 값을 입력합니다.
    targetDt 문자열(필수) 조회하고자 하는 날짜를 yyyymmdd 형식으로 입력합니다.
    weekGb 문자열 주간/주말/주중을 선택 입력합니다
    “0” : 주간 (월~일)
    “1” : 주말 (금~일) (default)
    “2” : 주중 (월~목)
    itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”, 최대 : “10”)
    multiMovieYn 문자열 다양성 영화/상업영화를 구분지어 조회할 수 있습니다.
    “Y” : 다양성 영화 “N” : 상업영화 (default : 전체)
    repNationCd 문자열 한국/외국 영화별로 조회할 수 있습니다.
    “K: : 한국영화 “F” : 외국영화 (default : 전체)
    wideAreaCd 문자열 상영지역별로 조회할 수 있으며, 지역코드는 공통코드 조회 서비스에서 “0105000000” 로서 조회된 지역코드입니다. (default : 전체)
  • 응답 구조
    응답 필드값설명
    boxofficeType 문자열 박스오피스 종류를 출력합니다.
    showRange 문자열 대상 상영기간을 출력합니다.
    yearWeekTime 문자열 조회일자에 해당하는 연도와 주차를 출력합니다.(YYYYIW)
    rnum 문자열 순번을 출력합니다.
    rank 문자열 해당일자의 박스오피스 순위를 출력합니다.
    rankInten 문자열 전일대비 순위의 증감분을 출력합니다.
    rankOldAndNew 문자열 랭킹에 신규진입여부를 출력합니다.
    “OLD” : 기존 , “NEW” : 신규
    movieCd 문자열 영화의 대표코드를 출력합니다.
    movieNm 문자열 영화명(국문)을 출력합니다.
    openDt 문자열 영화의 개봉일을 출력합니다.
    salesAmt 문자열 해당일의 매출액을 출력합니다.
    salesShare 문자열 해당일자 상영작의 매출총액 대비 해당 영화의 매출비율을 출력합니다.
    salesInten 문자열 전일 대비 매출액 증감분을 출력합니다.
    salesChange 문자열 전일 대비 매출액 증감 비율을 출력합니다.
    salesAcc 문자열 누적매출액을 출력합니다.
    audiCnt 문자열 해당일의 관객수를 출력합니다.
    audiInten 문자열 전일 대비 관객수 증감분을 출력합니다.
    audiChange 문자열 전일 대비 관객수 증감 비율을 출력합니다.
    audiAcc 문자열 누적관객수를 출력합니다.
    scrnCnt 문자열 해당일자에 상영한 스크린수를 출력합니다.
    showCnt 문자열 해당일자에 상영된 횟수를 출력합니다.

3. 공통코드 조회 API 서비스

 

특정 코드값을 조건으로 그에 해당하는 하위 코드정보를 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
    요청 변수값설명
    key 문자열(필수) 발급받은키 값을 입력합니다.
    comCode 문자열(필수) 조회하고자 하는 상위 코드를 입력합니다.
  • 응답 구조
    응답 필드값설명
    fullCd 문자열 상위코드를 출력합니다
    korNm 문자열 해당 코드의 국문명을 출력합니다.
    engNm 문자열 해당 코드의 영문명을 출력합니다.
 

4. 영화목록 조회 API 서비스

 

통합전산망에서 사용되는 영화목록을 영화명, 감독명등의 조건을 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
 
요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
curPage 문자열 현재 페이지를 지정합니다.(default : “1”)
itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”)
movieNm 문자열 영화명으로 조회합니다. (UTF-8 인코딩)
directorNm 문자열 감독명으로 조회합니다. (UTF-8 인코딩)
openStartDt 문자열 YYYY형식의 조회시작 개봉연도를 입력합니다.
openEndDt 문자열 YYYY형식의 조회종료 개봉연도를 입력합니다.
prdtStartYear 문자열 YYYY형식의 조회시작 제작연도를 입력합니다.
prdtEndYear 문자열 YYYY형식의 조회종료 제작연도를 입력합니다.
repNationCd 문자열 N개의 국적으로 조회할 수 있으며, 국적코드는 공통코드 조회 서비스에서 “2204” 로서 조회된 국적코드입니다. (default : 전체)
movieTypeCd 문자열 N개의 영화유형코드로 조회할 수 있으며, 영화유형코드는 공통코드 조회 서비스에서 “2201”로서 조회된 영화유형코드입니다.
(default: 전체)

 

응답 필드값설명
movieCd 문자열 영화코드를 출력합니다.
movieNm 문자열 영화명(국문)을 출력합니다.
movieNmEn 문자열 영화명(영문)을 출력합니다.
prdtYear 문자열 제작연도를 출력합니다.
openDt 문자열 개봉일을 출력합니다.
typeNm 문자열 영화유형을 출력합니다.
prdtStatNm 문자열 제작상태를 출력합니다.
nationAlt 문자열 제작국가(전체)를 출력합니다.
genreAlt 문자열 영화장르(전체)를 출력합니다.
repNationNm 문자열 대표 제작국가명을 출력합니다.
repGenreNm 문자열 대표 장르명을 출력합니다.
directors 문자열 영화감독을 나타냅니다.
peopleNm 문자열 영화감독명을 출력합니다.
companys 문자열 제작사를 나타냅니다.
companyCd 문자열 제작사 코드를 출력합니다.
companyNm 문자열 제작사명을 출력합니다.

 

4. 응답 예시

 

 

5. 영화상세정보 조회 API 서비스

 

통합전산망에서 사용되는 영화상세정보를 영화코드를 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
movieCd 문자열(필수) 영화코드를 지정합니다.
  • 응답 구조
응답 필드값설명
movieCd 문자열 영화코드를 출력합니다.
movieNm 문자열 영화명(국문)을 출력합니다.
movieNmEn 문자열 영화명(영문)을 출력합니다.
movieNmOg 문자열 영화명(원문)을 출력합니다.
prdtYear 문자열 제작연도를 출력합니다.
showTm 문자열 상영시간을 출력합니다.
openDt 문자열 개봉연도를 출력합니다.
prdtStatNm 문자열 제작상태명을 출력합니다.
typeNm 문자열 영화유형명을 출력합니다.
nations 문자열 제작국가를 나타냅니다.
nationNm 문자열 제작국가명을 출력합니다.
genreNm 문자열 장르명을 출력합니다.
directors 문자열 감독을 나타냅니다.
peopleNm 문자열 감독명을 출력합니다.
peopleNmEn 문자열 감독명(영문)을 출력합니다.
actors 문자열 배우를 나타냅니다.
peopleNm 문자열 배우명을 출력합니다.
peopleNmEn 문자열 배우명(영문)을 출력합니다.
cast 문자열 배역명을 출력합니다.
castEn 문자열 배역명(영문)을 출력합니다.
showTypes 문자열 상영형태 구분을 나타냅니다.
showTypeGroupNm 문자열 상영형태 구분을 출력합니다.
showTypeNm 문자열 상영형태명을 출력합니다.
audits 문자열 심의정보를 나타냅니다.
auditNo 문자열 심의번호를 출력합니다.
watchGradeNm 문자열 관람등급 명칭을 출력합니다.
companys 문자열 참여 영화사를 나타냅니다.
companyCd 문자열 참여 영화사 코드를 출력합니다.
companyNm 문자열 참여 영화사명을 출력합니다.
companyNmEn 문자열 참여 영화사명(영문)을 출력합니다.
companyPartNm 문자열 참여 영화사 분야명을 출력합니다.
staffs 문자열 스텝을 나타냅니다.
peopleNm 문자열 스텝명을 출력합니다.
peopleNmEn 문자열 스텝명(영문)을 출력합니다.
staffRoleNm 문자열 스텝역할명을 출력합니다.

 

4. 응답 예시 

 
 

 

6.영화사목록 조회 API 서비스

 

통합전산망에서 사용되는 영화사목록을 영화사명, 대표자명등의 조건을 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
curPage 문자열 현재 페이지를 지정합니다.(default : “1”)
itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”)
companyNm 문자열 영화사명으로 조회합니다.
ceoNm 문자열 대표자명으로 조회합니다.
companyPartCd 문자열 N개의 분류코드로 조회할 수 있으며, 분류코드는 공통코드 조회 서비스에서 “2601” 로서 조회된 분류코드입니다.(default: 전체)
  • 응답구조
응답 필드값설명
companyCd 문자열 영화사 코드를 출력합니다.
companyNm 문자열 영화사명을 출력합니다.
companyNmEn 문자열 영화사명(영문)을 출력합니다.
companyPartNames 문자열 영화사 분류를 출력합니다.
ceoNm 문자열 대표자명을 출력합니다.
filmoNames 문자열 필모리스트를 출력합니다.

4. 응답 예시

7.영화사 상세정보 조회 API 서비스

 

통합전산망에서 사용되는 영화사 상세정보를 영화사코드를 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
companyCd 문자열 영화사코드를 지정합니다.
 
응답 필드값설명
companyCd 문자열 영화사 코드를 출력합니다.
companyNm 문자열 영화사명을 출력합니다.
companyNmEn 문자열 영화사명(영문)을 출력합니다.
ceoNm 문자열 대표자명을 출력합니다.
parts 문자열 영화사 분류를 나타냅니다.
companyPartNm 문자열 영화사 분류명을 출력합니다.
filmos 문자열 영화사 필모를 나타냅니다.
movieCd 문자열 참여 영화코드를 출력합니다.
movieNm 문자열 참여 영화명을 출력합니다.
companyPartNm 문자열 영화사 참여 분류명을 출력합니다.

4. 응답 예시

 

8.영화인목록 조회 API 서비스

 

통합전산망에서 사용되는 영화인목록을 영화인명, 필모그래피의 조건을 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

  • 요청 인터페이스
 
요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
curPage 문자열 현재 페이지를 지정합니다.(default : “1”)
itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”)
peopleNm 문자열 영화인명으로 조회합니다.
filmoNames 문자열 필모리스트로 조회합니다.
 
응답 필드값설명
peopleCd 문자열 영화인 코드를 출력합니다.
peopleNm 문자열 영화인명을 출력합니다.
peopleNmEn 문자열 영화인명(영문)을 출력합니다.
repRoleNm 문자열 분야를 출력합니다.
filmoNames 문자열 필모리스트를 출력합니다.

 

 

4. 응답 예시

 

9. 영화인 상세정보 조회 API 서비스

 

통합전산망에서 사용되는 영화인 상세정보를 영화인코드를 통해 조회합니다.
REST/SOAP 방식 중 선택적으로 호출가능하며 REST 방식의 응답형식은 XML과 JSON을 지원합니다.( URI의 extension으로 구분)

1. REST 방식

2. SOAP 방식


3. 인터페이스

요청 인터페이스

요청 변수값설명
key 문자열(필수) 발급받은키 값을 입력합니다.
peopleCd 문자열 영화인코드를 지정합니다.
응답 필드값설명
peopleCd 문자열 영화인 코드를 출력합니다.
peopleNm 문자열 영화인명을 출력합니다.
peopleNmEn 문자열 영화인명(영문)을 출력합니다.
sex 문자열 성별을 출력합니다.
repRoleNm 문자열 영화인 분류명을 출력합니다.
filmos 문자열 영화인 필모를 나타냅니다.
movieCd 문자열 참여 영화코드를 출력합니다.
movieNm 문자열 참여 영화명을 출력합니다.
moviePartNm 문자열 참여분야를 나타냅니다.
homepages 문자열 관련 URL을 출력합니다.

 

 

4. 응답 예시

728x90
반응형
저작자표시 비영리 변경금지

'IT > API' 카테고리의 다른 글

자바스크립트 fetch와 async/await 의 사용법  (0) 2023.02.18
fetch 구문 사용을 위한 chatGPT3 와의 대화  (0) 2023.02.18
Axios vs Fetch 사용법  (0) 2023.02.18
티스토리 블로그 자동화를 위하여 꼭 거쳐야 할 6가지 기술과 8가지 단계  (0) 2023.02.12
네이버 통합 검색어 트렌드 조회 API  (1) 2023.01.31

관련글 더보기

티스토리툴바