1.1 공연목록정보조회서비스 공연목록정보조회개요 서비스일련번호 서비스정보서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스명 ( 국문 ) 공연목록정보조회서비스 서비스명 ( 영문 ) pblprfrservice 서비스설명 공연목록정보목록및상세내용을조회

1.1 공연목록정보조회서비스 1.1.1 공연목록정보조회개요 서비스일련번호 서비스정보서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스명 ( 국문 ) 공연목록정보조회서비스 서비스명 ( 영문 ) pblprfrservice 서비스설명 공연목록정보목록및상세내용을조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터 [ O ] XML [ ] JSON [ ] MIME [ ] 표준 MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/pblprfr 최종서비스 2.0 버전 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 1.1.2 공연목록조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연목록조회오퍼레이션을요청한다. 1.1 만일그결과로조회목록이있으면공연상세정보조회를요청한다.

1.2 조회조건에해당하는자료가없을경우 1.2.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.2.2 조회조건을변경하여공연목록조회오퍼레이션을요청한다. 1.1.3 공연목록조회서비스오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/pblprfr 공연목록조회 2 GET /openapi/restful/pblprfr/{ 공연아이디 } 공연상세정보조회 1.1.4 공연목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 공연목록조회 /openapi/restful/pblprfr 오퍼레이션정보 오퍼레이션설명 공연정보를목록으로조회 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification pblpfrrequest 메시지정보응답메시지정보샘플 URL 메시지데이터타입 XML 메시지설명 공연정보목록을조회한다. 선행오퍼레이션 N/A pblpfrresponse 메시지데이터타입 XML 메시지설명 검색조건에해당하는공연정보목록을반환한다. 2014 년 01 월 01 부터 2014 년 01 월 30 일사이에공연중인정보검색요청 http://www.kopis.or.kr/openapi/restful/pblprfr?service={servicekey}&stdate=20140101&ed date=20140130&cpage=1&rows=10&prfnm=&prfstatus=02&signgucode=&shcate=

1.1.5 공연목록조회오퍼레이션메시지명세 요청메시지명세 pblpfrrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 공연시작일 8 필수 20140101 eddate 공연종료일 8 필수 20140130 cpage 현재페이지 3 필수 1 rows 페이지당 ROW 수 3 필수 10 shcate 장르 50 URLEncoding shprfnm 공연명 2 잭더리퍼 URLEncoding shprfnmfct 공연시설명 4 예술의전당 URLEncoding prfplccd 공연장코드 4 signgucode 지역 ( 시도 ) signgucodesub 지역 ( 구군 ) kidstate 아동공연 Y prfstate 공연상태 01 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 dbs db 공연정보목록 List 형 mt20id 공연 ID 3 PF003682 prfnm 공연명 20 토요명품공연 genrenm 공연장르명 60 국악 prfstate 공연상태 20 공연중 prfpdfrom 공연시작일 10 2014.11.01 prfpdto 공연종료일 50 2014.11.30 poster 공연포스터경로 10 http://www.naver.com

예술의 fcltynm 공연시설명 10 전당 ( 콘서트홀 ) openrun 오픈런 1 Y 1.1.6 공연상세정보조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 공연상세정보조회 오퍼레이션명 ( 영문 ) /openapi/restful/pblpfr/{ 공연아이디 } 오퍼레이션설명 공연상세정보를조회 오퍼레이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출메시지정보응답메시지정보샘플 URL 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification pblpfrdetailrequest 메시지데이터타입 XML 메시지설명 공연상세정보를조회한다. 선행오퍼레이션 N/A pblpfrdetailresponse 메시지데이터타입 XML 메시지설명 공연 ID 에해당하는공연의상세정보를반환한다. 공연 ID 가 PF003682 인공연에대한상세정보요청 http://www.kopis.or.kr/openapi/restful/pblprfr/pf003682?service={serivekey}

1.1.7 공연상세정보조회오퍼레이션메시지명세 요청메시지명세 pblpfrdetailrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } seq mt20id 공연 ID 20 필수 PF003682 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 dbs db 공연상세정보 mt20id 공연 ID 20 PF003682 prfnm 공연명 60 토요명품공연 prfpdfrom 공연시작일 20 2013.12.01 prfpdto 공연종료일 50 2013.12.31 fcltynm 공연시설명, 공연장명 10 예술의전당 ( 콘서트홀 ) prfcast 공연출연진 10 홍길동 prfcrew 공연제작진 3 임권택 prfruntime 공연런타임 100 prfage 공연관람연령 4 entrpsnm 제작사 1000 pcseguidance 티켓가격 1000 poster 공연포스터 sty 줄거리 genrenm 공연장르명 prfstate 공연상태 openrun 오픈런

2.1 공연시설정보조회서비스 2.1.1 공연시설정보조회개요 서비스일련번호 서비스정보서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명서비스인증 공연시설정보조회서비스 PrfplcService 공연시설정보목록및상세내용을조회 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS-Security [ ] Basic 인증 (ID/PW) [ ] 없음 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 인터페이스 (RPC-Encoded, Document Literal, Document Literal Wrapped) 표준 [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터 표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfplc 최종서비스 버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 2.1.2 공연시설조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연시설목록조회오퍼레이션을요청한다. 1.1 만일그결과로조회목록이있으면공연시설상세정보조회를요청한다. 1.2 조회조건에해당하는자료가없을경우 1.2.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.2.2 조회조건을변경하여공연시설목록조회오퍼레이션을요청한다.

2.1.3 공연시설조회서비스오퍼레이션목록 일련번호 오퍼레이 션 서비스 URI 오퍼레이션설명 1 GET /openapi/restful/prfplc 공연시설목록조회 2 GET /openapi/restful/prfplc/{ 공연시설아이디 } 공연시설상세정보조회 2.1.4 공연시설목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 공연시설목록조회 /openapi/restful/prfplc 공연시설정보를리스트로조회 오퍼레이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출메시지정보응답메시지정보샘플 URL 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfplcrequest 메시지데이터타입 XML 메시지설명 공연시설정보목록을조회한다. 선행오퍼레이션 N/A prfplcresponse 메시지데이터타입 XML 메시지설명검색조건에해당하는공연시설정보목록을반환한다. 예술의전당이라는공연시설명으로검색하여 10개단위의첫페이지를요청 http://www.kopis.or.kr/openapi/restful/prfplc?service={servicekey}&cpage=1&rows= 10&shprfnmfct=%EC%98%88%EC%88%A0%EC%9D%98%EC%A0%84%EB%8B%B9&fc tlychartr=&signgucode=&signgucodesub=

2.1.5 공연시설목록조회오퍼레이션메시지명세 요청메시지명세 prfplcrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } cpage 현재페이지 3 필수 1 rows 페이지당 ROW 수 3 필수 10 shprfnmfct 공연시설명 100 국립국악원 URLEncoding fcltychartr 공연시설특성 4 1100 signgucode 지역 ( 시도 ) 4 signgucodesub 지역 ( 구군 ) 4 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 dbs db 공연시설정보목록 List 형 mt10id 공연시설 ID 3 FC003682 fcltynm 공연시설명 20 mt13cnt 공연장수 60 fcltychartr 시설특성 20 sidonm 지역 ( 시도 ) 100 http://... gugunnm 지역 ( 구군 ) 50 서울 opende 개관연도 1000 1700 2.1.6 공연시설상세정보조회오퍼레이션명세 오퍼레이션 정보 오퍼레이션명 ( 국문 ) 공연시설상세정보조회 오퍼레이션명 ( 영문 ) /openapi/restful/prfplc/{ 공연시설아이디 } 오퍼레이션설명 공연시설상세정보를조회 Call Back (URL) N/A

최대메시지사이즈 [ 800K bytes] [ 500 평균응답시간 ms 초당최대트랜잭션 [ 30 tps] ] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준 성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출메시지정보응답메시지정보샘플 URL 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfplcdetailrequest 메시지데이터타입 XML 메시지설명 공연시설상세정보를조회한다. 선행오퍼레이션 N/A prfplcdetailresponse 메시지데이터타입 XML 메시지설명 공연시설 ID 에해당하는공연의상세정보를반환한다. 공연시설 ID 가 FC003682 인공연시설에대한상세정보요청 http://www.kopis.or.kr/openapi/restful/prfplc/fc000001?service={servicekey} 2.1.7 공연시설상세정보조회오퍼레이션메시지명세 요청메시지명세 prfplcdetailrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 1 { 서비스키 } mt10id 공연시설 ID 20 1 FC003682 항목설명 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 dbs db 공연상세정보 mt10id 공연시설 ID 20 FC3682

fcltynm 공연시설명 60 국립국악원 opende 개관연도 6 2012 fcltychartr 시설특성 50 seatscale 객석수 100 mt13cnt 공연장수 10 telno 전화번호 20 relateurl 홈페이지 20 adres 주소 10 la 위도 lo 경도 3.1 기획 / 제작사정보조회서비스 3.1.1 기획 / 제작사정보조회개요 서비스일련번호 서비스정보서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스명 ( 국문 ) 기획 / 제작사정보조회서비스 서비스명 ( 영문 ) MnfctService 서비스설명 기획 / 제작사정보목록을조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터 [ O ] XML [ ] JSON [ ] MIME [ ] 표준 MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/mnfct 최종서비스 버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스이력 서비스변경이력

2014.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 3.1.2 기획 / 제작사조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은기획 / 제작사목록조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여기획 / 제작사목록조회오퍼레이션을요청한다. 3.1.3 기획 / 제작사조회서비스오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/mnfct 기획 / 제작사목록조회 3.1.4 기획 / 제작사목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 기획 / 제작사목록조회 /openapi/restful/mnfct 기획 / 제작사정보를리스트로조회 오퍼레 이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body [ O ] Request-Response [ ] Publish-Subscribe 메시지교환유형 [ ] Fire-and-Forgot [ ] Notification mnfctrequest 호출메시지데이터타입 XML 메시지메시지설명기획 / 제작사정보목록을조회한다. 정보선행오퍼레이션 N/A 응답메 mnfctresponse

시지 정보 메시지데이터타입 XML 메시지설명검색조건에해당하는기획 / 제작사정보목록을반환한다. 기획 / 제작사명을예술경영으로검색한기획 / 제작사목록을 10 개단위의첫번째페이지 샘플 URL 요청 http://www.kopis.or.kr/openapi/restful/mnfct?service={servicekey}&cpage=1&rows=10 &entrpsnm=%ec%98%88%ec%88%a0%ea%b2%bd%ec%98%81&shcate= 3.1.5 기획 / 제작사목록조회오퍼레이션메시지명세 요청메시지명세 mnfctrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } cpage 현재페이지 3 필수 1 rows 페이지당 ROW 수 3 필수 10 entrpsnm 기획 / 제작사명 100 예술경영 URLEncoding shcate 장르 4 URLEncoding 응답메시지명세 dbs 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기샘플데이터항목설명 db 기획 / 제작사정보 목록 List 형 mt30id 기획 / 제작사 ID 3 entrpsnm 기획 / 제작사명 20 genrenm 장르 60 telno 전화번호 20 prfnm 주요작품 100 relateurl 홈페이지 50

4.1 주 / 월별정보조회서비스 4.1.1 주 / 월별정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 주 / 월별정보조회서비스 boxweekmonthlyservice 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스설명 주 / 월별정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/boxweekmonthly 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 4.1.2 주 / 월별조회흐름 << 기본흐름 >> 1. 사용자시스템은주 / 월별조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여주 / 월별오퍼레이션을요청한다.

4.1.3 주 / 월별조회오퍼레이션목록 일련번 호 오퍼레이 션 서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxweekmonthly/{ 주 / 월별 구분아이디 } 주 / 월별조회 4.1.4 주 / 월별조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 주 / 월별조회 오퍼레이션명 ( 영문 ) /openapi/restful/boxweekmonthly/{ 주 / 월별구분아이디 } 오퍼레이션설명 주 / 월별정보를리스트로조회 오퍼레이 션정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출메시지정보응답메시지정보 URL 샘플 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification boxweekmonthlyrequest 메시지데이터타입 XML 메시지설명 주 / 월별정보를조회한다. 선행오퍼레이션 N/A 항목구분 1 - not null, 2 - null boxweekmonthlyresponse 메시지데이터타입 XML 메시지설명검색조건에해당하는주 / 월별정보목록을반환한다. 주별박스오피스목록요청 http://www.kopis.or.kr/openapi/restful/boxweekmonthly?service={servicekey}&ststype= week&catecode=yk

4.1.5 주 / 월별조회오퍼레이션메시지명세 요청메시지명세 boxweekmonthlyrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 필수 { 서비스키 } ststype 박스오피스 1. month 주 / 월별 6 필수 2. week 구분아이디 catecode 장르구분 3 필수 YK 항목설명월별 - month 주별 - week 연극 : YK 뮤지컬 : MU 클래식 / 오페라 : CCO 무용 / 발레 : MMB 국악 / 복합 : KKB 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 boxofs boxof 주 / 월별목록 List 형 cate 장르 6 연극 rnum 순위 20 1 prfnm 공연명 20 [SAC CUBE 2015] 모리와함께한화요일 nmrs 관객수 20 1012 nmrsshr 점유율 20 35.1 prfpd 공연기간 20 2015.04.04~2015.04.19 prfplcnm 공연장명 20 자유소극장 seatcnt 좌석수 20 300 prfdtcnt 공연횟수 20 7 area 지역 20 서울

5.1 연도별조회서비스 5.1.1 연도별정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 연도별정보조회서비스 boxyearbyservice 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스설명 연도별정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/boxyearby 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 5.1.2 연도별조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은연도별조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여연도별조회오퍼레이션을요청한다.

5.1.3 연도별조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxyearby/ 연도별조회 5.1.4 연도별조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 연도별조회 /openapi/restful/boxyearby/ 연도별정보를리스트로조회 오퍼레 이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 메시지데이터타입 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification boxyearbyrequest XML 메시지 정보 메시지설명연도별정보를조회한다. 선행오퍼레이션 N/A 응답메 항목구분 1 - not null, 2 - null boxyearbyresponse 시지정보샘플 URL 메시지데이터타입 XML 메시지설명검색조건에해당하는연도별정보목록을반환한다. 2014 년도장르코드 AAAA, 지역코드 11 에대한연도별박스오피스목록요청 http://www.kopis.or.kr/openapi/restful/boxyearby?service={servicekey}&stdate=2014&s hcate=aaaa&sharea=11

5.1.5 연도별조회오퍼레이션메시지명세 요청메시지명세 boxyearbyrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 4 필수 2014 규칙 (YYYY) shcate 장르 4 필수 AAAA sharea 지역 2 11 shprfnm 공연명 50 NT 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 boxofs boxof 연도별정보목록 List 형 rnum 순위 4 1 prfnm 공연명 6 NT Live 워호스 cate 장르 20 연극 prfpd 공연기간 20 2014.03.15~2014. 03.16 prfdtcnt 공연횟수 20 3 mrs 관객수 20 2429 nmrsshr 관객점유율 20 0.1 area 지역 20 서울 prfplcnm 공연장 20 해오름극장 seatcnt 좌석수 20 1563

6.1 역대조회서비스 6.1.1 역대정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 역대정보조회서비스 boxyearthebyservice 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스설명 역대정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/boxyeartheby 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 6.1.2 역대조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은역대조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여역대조회오퍼레이션을요청한다.

6.1.3 역대조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxyeartheby/ 역대조회 6.1.4 역대조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 역대조회 /openapi/restful/boxyeartheby/ 역대정보를리스트로조회 오퍼레이 션정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 메시지데이터타입 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification boxyearthebyrequest XML 메시지정 보 메시지설명역대정보를조회한다. 선행오퍼레이션 N/A 응답메시 항목구분 1 - not null, 2 - null boxyearthebyresponse 지정보샘플 UR L 메시지데이터타입 XML 메시지설명검색조건에해당하는역대정보목록을반환한다. 지역코드 11 지역에대한역대별박스오피스목록요청 http://www.kopis.or.kr/openapi/restful/boxyeartheby?service={servicekey}&sharea=11 &shplace= 6.1.5 역대조회오퍼레이션메시지명세 요청메시지명세 boxyearthebyrequest

항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 필수 { 서비스키 } sharea 지역 2 11 shplace 공연장규모 2 1 항목설명대형 : 1000 석이상 -> 1 중대형 : 500~1000 석미만-> 2 중형 : 300~500 석미만-> 3 중소형 : 100~300 석미만-> 4 소형 : 100 석미만-> 5 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 boxofs boxof 역대정보목록 List 형 rnum 순위 4 1 prfnm 공연명 6 MISO, 배비장전 cate 장르 20 복합 prfpd 공연기간 20 2014.04.15~ 2015.02.22 prfdtcnt 공연횟수 20 416 nmrs 관객수 20 54542 area 지역 20 서울 prfplcnm 공연장 정동극장 seatcnt 좌석수 282 nmrsshr 점유율 2.5 7.1 총관객수및매출액정보조회서비스 7.1.1 총관객수및매출액정보조회개요 서비스정보 서비스일련번호

서비스명 ( 국문 ) 서비스명 ( 영문 ) 총관객수및매출액정보조회서비스 prfststotalservice 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스설명 총관객수및매출액정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfststotal 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 7.1.2 총관객수및매출액조회흐름 << 기본흐름 >> 1. 사용자시스템은총관객수및매출액조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여총관객수및매출액오퍼레이션을요청한다. 7.1.3 총관객수및매출액조회오퍼레이션목록 일련번 호 오퍼레이 션 서비스 URI 오퍼레이션설명

1 GET /openapi/restful/ prfststotal/{ 총관객수및매출액통계구분아이디 } 총관객수및매출액 조회 7.1.4 총관객수및매출액조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 총관객수및매출액조회 오퍼레이션명 ( 영문 ) /openapi/restful/ prfststotal/{ 총관객수및매출액통계구분아이디 } 오퍼레이션설명 총관객수및매출액정보를리스트로조회 오퍼레 이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 메시지데이터타입 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfststotalrequest XML 메시지 정보 메시지설명총관객수및매출액정보를조회한다. 선행오퍼레이션 N/A 응답메 항목구분 1 - not null, 2 - null prfststotalresponse 시지 정보 메시지데이터타입 XML 메시지설명검색조건에해당하는총관객수및매출액정보목록을반환한다. 2014 년도 1 월에대한일별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfststotal?service={servicekey}&ststype=day&std ate=201401 샘플 URL 2014 년도 1 월 1 일부터 2014 년도 1 월 4 일까지요일별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfststotal?service={servicekey}&ststype=daywee k&stdate=20140101&eddate=20140104 2014 년도의월별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfststotal?service={servicekey}&ststype=month& stdate=2014

7.1.5 총관객수및매출액조회오퍼레이션메시지명세 요청메시지명세 prfststotalrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 필수 { 서비스키 } 총관객수및 1. month ststype 매출액통계 6 필수 2. dayweek 구분아이디 3. day stdate 시작검색기 1. 2014 8 필수간 2. 20140101 항목설명월별 - month 요일별 - dayweek 일별 - day 월별 - 규칙 (YYYY) 요일별 - 규칙 (YYYYMMDD) 일별 - 규칙 (YYYYMM) { ststype } 이요일별때 eddate 종료검색기 간 8 필수 1. 20140101 사용 요일별 - 규칙 (YYYYMMDD) 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 통계정보목록 List 형 prfdt 년월일 6 20140101 ( 일별 ) 201401 ( 월별 ) 월요일 ( 요일별 ) prfprocnt 서울 / 경기- 공연프로그램건수 20 prfdtcnt 서울 / 경기 -공연횟수 20 amount 서울 / 경기 -매출액 20 천단위 nmrs 서울 / 경기 -관객수 20 nmrsshr 서울 / 경기 -점유율 20 eprfprocnt 이외-공연프로그램건수 20 eprfdtcnt 이외-공연횟수 20 eamount 이외-매출액 20

enmrs 이외 - 관객수 20 enmrsshr 이외 - 점유율 20 8.1 지역별통계조회서비스 8.1.1 지역별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 지역별통계정보조회서비스 prfstsareaservice 지역별통계정보목록조회 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfstsarea 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 8.1.2 지역별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은지역별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다.

1.1.2 조회조건을변경하여지역별통계조회오퍼레이션을요청한다. 8.1.3 지역별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsarea/ 지역별통계조회 8.1.4 지역별통계조회오퍼레이션명세 오퍼레 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 Call Back (URL) 지역별통계조회 /openapi/restful/prfstsarea/ 지역별통계정보를리스트로조회 N/A 이션 정보 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 메시지데이터타입 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfstsarearequest XML 메시지 정보 메시지설명지역별통계정보를조회한다. 선행오퍼레이션 N/A 응답메 항목구분 1 - not null, 2 - null prfstsarearesponse 시지정보샘플 URL 메시지데이터타입 XML 메시지설명검색조건에해당하는지역별통계정보목록을반환한다. 2014 년 1 월 1 일부터 2014 년 1 월 20 일까지의지역별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfstsarea?service={servicekey}&stdate=2014010 1&eddate=20140120

8.1.5 지역별통계조회오퍼레이션메시지명세 요청메시지명세 prfstsarearequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 6 필수 20140101 eddate 종료검색기간 6 필수 20140101 항목설명 규칙 (YYYYMMDD) 규칙 (YYYYMMDD) 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 Prfsts prfst 지역통계정보목록 List 형 area 지역 6 서울 prfprcnt 프로그램건수 20 55 prfdtcnt 공연횟수 20 256 amount 매출액 20 711289 천단위 amountshr 매출액점유율 20 100 nmrs 관객수 20 60268 nmrsshr 관객수점유율 20 100 9.1 장르별통계조회서비스 9.1.1 장르별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 장르별통계정보조회서비스 prfstscateservice 서비스설명 장르별통계정보목록조회 서비스보안 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] Basic 인증 (ID/PW) [ ] 없음 [ ] WS- Security

적용기술수준서비스 URL/URI 서비스배포정보 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfstscate 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 9.1.2 장르별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은장르별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여장르별통계조회오퍼레이션을요청한다. 9.1.3 장르별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstscate/ 장르별통계조회 9.1.4 장르별통계조회오퍼레이션명세 오퍼레 이션 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 장르별통계조회 /openapi/restful/prfstscate/

정보오퍼레이션설명장르별통계정보를리스트로조회 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준 성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 호출 메시지교환유형 메시지데이터타입 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfstscaterequest XML 메시지 정보 메시지설명장르별통계정보를조회한다. 선행오퍼레이션 N/A 응답메 항목구분 1 - not null, 2 - null prfstscateresponse 시지정보 샘플 RL U 메시지데이터타입 XML 메시지설명검색조건에해당하는장르별통계정보목록을반환한다. 2014 년 1 월 1 일부터 2014 년 1 월 20 일까지의장르별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfstscate?service={servicekey}&stdate=2014010 1&eddate=20140120 9.1.5 장르별통계조회오퍼레이션메시지명세 요청메시지명세 prfstscaterequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 6 필수 20140101 eddate 종료검색기간 6 필수 20140101 규칙 (YYYYMMDD) 규칙 (YYYYMMDD) 응답메시지명세

항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 Prfsts prfst 장르별통계정보목록 List 형 cate 장르 6 연극 prfprocnt 프로그램건수 20 14 prfdtcnt 공연횟수 20 74 amount 매출액 20 56564 천단위 amountshr 매출액점유율 20 8.0 nmrs 관객수 20 6730 nmrsshr 관객수점유율 20 11.2 10.1 창작구분별통계조회서비스 10.1.1 창작구분별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 창작구분별통계정보조회서비스 prfstscreateservice 서비스보안적용기술수준서비스 URL/URI 서비스배포정보 서비스설명 창작구분별통계정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfstscreate 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스이력 서비스변경이력

2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 10.1.2 창작구분별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은창작구분별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여창작구분별통계조회오퍼레이션을요청한다. 10.1.3 창작구분별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstscreate/ 창작구분별통계조회 10.1.4 창작구분별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 창작구분별통계조회 /openapi/restful/prfstscreate/ 창작구분별통계정보를리스트로조회 오퍼레 이션 정보 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준 성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification prfstscreaterequest 호출 메시지데이터타입 XML 메시지 메시지설명 창작구분별통계정보를조회한다. 정보 선행오퍼레이션 N/A 항목구분 1 - not null, 2 - null 응답메 prfstscreateresponse

시지 정보 메시지데이터타입 XML 메시지설명검색조건에해당하는창작구분별통계정보목록을반환한다. 샘플 RL U 2014 년 1 월 1 일부터 2014 년 1 월 0 일까지의창작구분별관객수및매출액목록요청 http://www.kopis.or.kr/openapi/restful/prfstscreate?service={servicekey}&stdate=20140 101&eddate=20140120 10.1.5 창작구분별통계조회오퍼레이션메시지명세 요청메시지명세 prfstscreaterequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 6 필수 20140101 eddate 종료검색기간 6 필수 20140101 규칙 (YYYYMMDD) 규칙 (YYYYMMDD)

응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 창작구분별통계정보목록 List 형 cate 장르 6 연극 creategbn 창작구분 20 국내 prfprocnt 프로그램건수 20 12 prfdtcnt 공연횟수 20 52 amount 매출액 20 35232 천단위 amountshr 매출액점유율 20 88.5 nmrs 관객수 20 5794 nmrsshr 관객수점유율 20 88.5 11.1 공연별통계조회서비스 11.1.1 공연별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 공연별통계정보조회서비스 prfstsprfbyservice 서비스보안 적용기술 수준 서비스설명 공연별통계정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 기타표준 [ ] WSRP [ ] 기타 ( )

서비스 URL/URI 서비스배포정보 운영환경 http://www.kopis.or.kr/openapi/restful/prfstsprfby 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 11.1.2 공연별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여공연별통계조회오퍼레이션을요청한다. 11.1.3 공연별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsprfby/ 공연별통계조회 11.1.4 공연별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 공연별통계조회 /openapi/restful/prfstsprfby/ 오퍼레이션정보 오퍼레이션설명 공연별통계정보를리스트로조회 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준 성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification 호출 prfstsprfbyrequest

메시 지정 보 메시지데이터타입 XML 메시지설명 공연별통계정보를조회한다. 선행오퍼레이션 N/A 항목구분 1 - not null, 2 - null 응답메시지정보 prfstsprfbyresponse 메시지데이터타입 XML 메시지설명 검색조건에해당하는공연별통계정보목록을반환한다. 2015 년 1 월 1 일부터 2015 년 12 월 30 일까지의 NT 라는공연명의장르코드 샘플 URL AAAA( 연극 ) 인 NT 라는공연명의통계요청 http://www.kopis.or.kr/openapi/restful/prfstsprfby?service={servicekey}&cpage=1&rows=1 0&stdate=20150101&eddate=201501230&shcate=AAAA&shprfnm=NT 11.1.5 공연별통계조회오퍼레이션메시지명세 요청메시지명세 prfstsprfbyrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } cpage 현재페이지 3 필수 1 rows 페이지당 ROW 수 3 필수 10 stdate 시작검색기간 6 필수 20140101 규칙 (YYYYMMDD) eddate 종료검색기간 6 필수 20140101 규칙 (YYYYMMDD) AAAA : 연극 AAAB : 뮤지컬 BBBA : 무용 shcate 장르 4 AAAA BBBB : 발레 CCCA : 클래식 CCCB : 오페라 CCCC : 국악

EEEA : 복합 shprfnm 공연명 100 NT URLEncoding 필요 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 공연별통계정보목록 List 형 prfnm 공연명 50 NT Live 프랑켄슈타인 cate 장르 20 연극 fcltynm 공연장 20 국립극장 entrpsnm 기획 / 제작사 20 국립극장 천단위 prfpdfrom 공연시작일 20 2015.02.25 prfpdto 공연종료일 20 2015.03.01 prfdtcnt 공연횟수 20 6 totnmrs 총관객수 20 3706 12.1 공연시설별통계조회서비스 12.1.1 공연시설별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 공연시설별통계정보조회서비스 prfstsprfbyfctservice 서비스보안 적용기술 수준 서비스설명 공연시설별통계정보목록조회 서비스인증 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ ] WS- [ ] Basic 인증 (ID/PW) [ ] 없음 Security 전송레벨암호화 [ O ] 없음 [ ] SSL [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal 인터페이스표준 Wrapped) [ O ] REST [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM

서비스 URL/URI 서비스배포정보 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 http://www.kopis.or.kr/openapi/restful/prfstsprfbyfct 최종서비스버전 2.0 유효일자 2099.12.31 배포일자 2015.05.01 서비스변경이력 서비스이력 2015.05.01 : Version 2.0 배포 2014.01.01 : Version 1.0 배포 사용제약사항 ( 비고 ) 12.1.2 공연시설별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연시설별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 1.1.1 ' 조회된내용이없습니다 ' 메시지를출력한다. 1.1.2 조회조건을변경하여공연시설별통계조회오퍼레이션을요청한다. 12.1.3 공연시설별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsprfbyfct/ 공연시설별통계조회 12.1.4 공연시설별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 공연시설별통계조회 오퍼레이션정보 오퍼레이션명 ( 영문 ) /openapi/restful/prfstsprfbyfct/ 오퍼레이션설명 공연시설별통계정보를리스트로조회 Call Back (URL) N/A 최대메시지사이즈 [ 800K bytes] 평균응답시간 [ 500 ms] 초당최대트랜잭션 [ 30 tps] 메시지레벨암호화 [ O ] 없음 [ ] 비밀키 [ ] 공개키 메시지로깅수준 성공 : [O] Header [ ] Body 실패 : [O] Header [] Body 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification

호 출 메 시 지 정 보 응 답 메 시 지 정 보 샘 플 UR L prfstsprfbyfctrequest 메시지데이터타입 XML 메시지설명 공연시설별통계정보를조회한다. 선행오퍼레이션 N/A 항목구분 1 - not null, 2 - null prfstsprfbyfctresponse 메시지데이터타입 XML 메시지설명 검색조건에해당하는공연시설별통계정보목록을반환한다. 205 년 1 월 1 일부터 2015 년 3 월 31 일까지의지역코드 11 에대한공연시설명이 예술의전당인공연시설의통계요청 http://www.kopis.or.kr/openapi/restful/prfstsprfbyfct?service={servicekey}&cpage=1&rows= 10&stdate=20150101&eddate=20150331&sharea=11&shprfnmfct=%EC%98%88%EC%88% A0%EC%9D%98%EC%A0%84%EB%8B%B9 12.1.5 공연시설별통계조회오퍼레이션메시지명세 요청메시지명세 prfstsprfbyfctrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 6 필수 20140101 규칙 (YYYYMMDD) eddate 종료검색기간 6 필수 20140101 규칙 (YYYYMMDD) 11 : 서울 sharea 지역 2 11 26 : 부산 27 : 대구 28 : 인천

29 : 광주 30 : 대전 31 : 울산 36 : 세종 41 : 경기도 42 : 강원도 43 : 충청북도 44 : 충청남도 45 : 전라북도 46 : 전라남도 47 : 경상북도 48 : 경상남도 50 : 제주 shprfnmfct 공연시설명 100 예술의전당 URLEncoding 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 공연시설별통계정보목록 List 형 prfnmfct 공연시설명 50 예술의전당 prfnmplc 공연장명 50 CJ 토월극장 seatcnt 좌석수 20 1004 prfprocnt 공연건수 20 1 prfdtcnt 공연횟수 20 102 totnmrs 총관객수 20 12178 nmrsshr 점유율 20 3.2