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

Transcription

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 [ ] 기타 ( ) 운영환경 최종서비스 2.0 버전 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 공연목록조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연목록조회오퍼레이션을요청한다. 1.1 만일그결과로조회목록이있으면공연상세정보조회를요청한다.

2 1.2 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여공연목록조회오퍼레이션을요청한다 공연목록조회서비스오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/pblprfr 공연목록조회 2 GET /openapi/restful/pblprfr/{ 공연아이디 } 공연상세정보조회 공연목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 공연목록조회 /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 메시지설명 검색조건에해당하는공연정보목록을반환한다 년 01 월 01 부터 2014 년 01 월 30 일사이에공연중인정보검색요청 date= &cpage=1&rows=10&prfnm=&prfstatus=02&signgucode=&shcate=

3 1.1.5 공연목록조회오퍼레이션메시지명세 요청메시지명세 pblpfrrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 공연시작일 8 필수 eddate 공연종료일 8 필수 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 PF prfnm 공연명 20 토요명품공연 genrenm 공연장르명 60 국악 prfstate 공연상태 20 공연중 prfpdfrom 공연시작일 prfpdto 공연종료일 poster 공연포스터경로 10

4 예술의 fcltynm 공연시설명 10 전당 ( 콘서트홀 ) openrun 오픈런 1 Y 공연상세정보조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 공연상세정보조회 오퍼레이션명 ( 영문 ) /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 가 PF 인공연에대한상세정보요청

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

6 2.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 [ ] 기타 ( ) 운영환경 최종서비스 버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 공연시설조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연시설목록조회오퍼레이션을요청한다. 1.1 만일그결과로조회목록이있으면공연시설상세정보조회를요청한다. 1.2 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여공연시설목록조회오퍼레이션을요청한다.

7 2.1.3 공연시설조회서비스오퍼레이션목록 일련번호 오퍼레이 션 서비스 URI 오퍼레이션설명 1 GET /openapi/restful/prfplc 공연시설목록조회 2 GET /openapi/restful/prfplc/{ 공연시설아이디 } 공연시설상세정보조회 공연시설목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 공연시설목록조회 /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개단위의첫페이지를요청 10&shprfnmfct=%EC%98%88%EC%88%A0%EC%9D%98%EC%A0%84%EB%8B%B9&fc tlychartr=&signgucode=&signgucodesub=

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

9 최대메시지사이즈 [ 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 가 FC 인공연시설에대한상세정보요청 공연시설상세정보조회오퍼레이션메시지명세 요청메시지명세 prfplcdetailrequest 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 MsgBody service 서비스키 60 1 { 서비스키 } mt10id 공연시설 ID 20 1 FC 항목설명 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 dbs db 공연상세정보 mt10id 공연시설 ID 20 FC3682

10 fcltynm 공연시설명 60 국립국악원 opende 개관연도 fcltychartr 시설특성 50 seatscale 객석수 100 mt13cnt 공연장수 10 telno 전화번호 20 relateurl 홈페이지 20 adres 주소 10 la 위도 lo 경도 3.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 [ ] 기타 ( ) 운영환경 최종서비스 버전 2.0 유효일자 배포일자 서비스이력 서비스변경이력

11 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 기획 / 제작사조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은기획 / 제작사목록조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여기획 / 제작사목록조회오퍼레이션을요청한다 기획 / 제작사조회서비스오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/mnfct 기획 / 제작사목록조회 기획 / 제작사목록조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 기획 / 제작사목록조회 /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

12 시지 정보 메시지데이터타입 XML 메시지설명검색조건에해당하는기획 / 제작사정보목록을반환한다. 기획 / 제작사명을예술경영으로검색한기획 / 제작사목록을 10 개단위의첫번째페이지 샘플 URL 요청 &entrpsnm=%ec%98%88%ec%88%a0%ea%b2%bd%ec%98%81&shcate= 기획 / 제작사목록조회오퍼레이션메시지명세 요청메시지명세 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

13 4.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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 주 / 월별조회흐름 << 기본흐름 >> 1. 사용자시스템은주 / 월별조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여주 / 월별오퍼레이션을요청한다.

14 4.1.3 주 / 월별조회오퍼레이션목록 일련번 호 오퍼레이 션 서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxweekmonthly/{ 주 / 월별 구분아이디 } 주 / 월별조회 주 / 월별조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 주 / 월별조회 오퍼레이션명 ( 영문 ) /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 메시지설명검색조건에해당하는주 / 월별정보목록을반환한다. 주별박스오피스목록요청 week&catecode=yk

15 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 관객수 nmrsshr 점유율 prfpd 공연기간 ~ prfplcnm 공연장명 20 자유소극장 seatcnt 좌석수 prfdtcnt 공연횟수 20 7 area 지역 20 서울

16 5.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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 연도별조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은연도별조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여연도별조회오퍼레이션을요청한다.

17 5.1.3 연도별조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxyearby/ 연도별조회 연도별조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 연도별조회 /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 메시지설명검색조건에해당하는연도별정보목록을반환한다 년도장르코드 AAAA, 지역코드 11 에대한연도별박스오피스목록요청 hcate=aaaa&sharea=11

18 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 공연기간 ~ prfdtcnt 공연횟수 20 3 mrs 관객수 nmrsshr 관객점유율 area 지역 20 서울 prfplcnm 공연장 20 해오름극장 seatcnt 좌석수

19 6.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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 역대조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은역대조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여역대조회오퍼레이션을요청한다.

20 6.1.3 역대조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ boxyeartheby/ 역대조회 역대조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 역대조회 /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 지역에대한역대별박스오피스목록요청 &shplace= 역대조회오퍼레이션메시지명세 요청메시지명세 boxyearthebyrequest

21 항목명 ( 영문 ) 항목명항목항목 ( 국문 ) 크기구분 샘플데이터 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 공연기간 ~ prfdtcnt 공연횟수 nmrs 관객수 area 지역 20 서울 prfplcnm 공연장 정동극장 seatcnt 좌석수 282 nmrsshr 점유율 총관객수및매출액정보조회서비스 총관객수및매출액정보조회개요 서비스정보 서비스일련번호

22 서비스명 ( 국문 ) 서비스명 ( 영문 ) 총관객수및매출액정보조회서비스 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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 총관객수및매출액조회흐름 << 기본흐름 >> 1. 사용자시스템은총관객수및매출액조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여총관객수및매출액오퍼레이션을요청한다 총관객수및매출액조회오퍼레이션목록 일련번 호 오퍼레이 션 서비스 URI 오퍼레이션설명

23 1 GET /openapi/restful/ prfststotal/{ 총관객수및매출액통계구분아이디 } 총관객수및매출액 조회 총관객수및매출액조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 총관객수및매출액조회 오퍼레이션명 ( 영문 ) /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 메시지설명검색조건에해당하는총관객수및매출액정보목록을반환한다 년도 1 월에대한일별관객수및매출액목록요청 ate= 샘플 URL 2014 년도 1 월 1 일부터 2014 년도 1 월 4 일까지요일별관객수및매출액목록요청 k&stdate= &eddate= 년도의월별관객수및매출액목록요청 stdate=2014

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

25 enmrs 이외 - 관객수 20 enmrsshr 이외 - 점유율 지역별통계조회서비스 지역별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 지역별통계정보조회서비스 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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 지역별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은지역별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다.

26 1.1.2 조회조건을변경하여지역별통계조회오퍼레이션을요청한다 지역별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsarea/ 지역별통계조회 지역별통계조회오퍼레이션명세 오퍼레 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 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 메시지설명검색조건에해당하는지역별통계정보목록을반환한다 년 1 월 1 일부터 2014 년 1 월 20 일까지의지역별관객수및매출액목록요청 1&eddate=

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

28 적용기술수준서비스 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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 장르별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은장르별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여장르별통계조회오퍼레이션을요청한다 장르별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstscate/ 장르별통계조회 장르별통계조회오퍼레이션명세 오퍼레 이션 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 장르별통계조회 /openapi/restful/prfstscate/

29 정보오퍼레이션설명장르별통계정보를리스트로조회 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 메시지설명검색조건에해당하는장르별통계정보목록을반환한다 년 1 월 1 일부터 2014 년 1 월 20 일까지의장르별관객수및매출액목록요청 1&eddate= 장르별통계조회오퍼레이션메시지명세 요청메시지명세 prfstscaterequest 항목명 ( 영문 ) 항목명 ( 국문 ) 항목 크기 항목 구분 샘플데이터 항목설명 MsgBody service 서비스키 60 필수 { 서비스키 } stdate 시작검색기간 6 필수 eddate 종료검색기간 6 필수 규칙 (YYYYMMDD) 규칙 (YYYYMMDD) 응답메시지명세

30 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 Prfsts prfst 장르별통계정보목록 List 형 cate 장르 6 연극 prfprocnt 프로그램건수 prfdtcnt 공연횟수 amount 매출액 천단위 amountshr 매출액점유율 nmrs 관객수 nmrsshr 관객수점유율 창작구분별통계조회서비스 창작구분별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 창작구분별통계정보조회서비스 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 [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스이력 서비스변경이력

31 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 창작구분별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은창작구분별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여창작구분별통계조회오퍼레이션을요청한다 창작구분별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstscreate/ 창작구분별통계조회 창작구분별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션설명 창작구분별통계조회 /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

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

33 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 창작구분별통계정보목록 List 형 cate 장르 6 연극 creategbn 창작구분 20 국내 prfprocnt 프로그램건수 prfdtcnt 공연횟수 amount 매출액 천단위 amountshr 매출액점유율 nmrs 관객수 nmrsshr 관객수점유율 공연별통계조회서비스 공연별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 공연별통계정보조회서비스 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 [ ] 기타 ( )

34 서비스 URL/URI 서비스배포정보 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 공연별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여공연별통계조회오퍼레이션을요청한다 공연별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsprfby/ 공연별통계조회 공연별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 오퍼레이션명 ( 영문 ) 공연별통계조회 /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

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

36 EEEA : 복합 shprfnm 공연명 100 NT URLEncoding 필요 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 샘플데이터 항목설명 prfsts prfst 공연별통계정보목록 List 형 prfnm 공연명 50 NT Live 프랑켄슈타인 cate 장르 20 연극 fcltynm 공연장 20 국립극장 entrpsnm 기획 / 제작사 20 국립극장 천단위 prfpdfrom 공연시작일 prfpdto 공연종료일 prfdtcnt 공연횟수 20 6 totnmrs 총관객수 공연시설별통계조회서비스 공연시설별통계정보조회개요 서비스일련번호 서비스정보 서비스명 ( 국문 ) 서비스명 ( 영문 ) 공연시설별통계정보조회서비스 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

37 서비스 URL/URI 서비스배포정보 기타표준 [ ] WSRP [ ] 기타 ( ) 운영환경 최종서비스버전 2.0 유효일자 배포일자 서비스변경이력 서비스이력 : Version 2.0 배포 : Version 1.0 배포 사용제약사항 ( 비고 ) 공연시설별통계조회서비스흐름 << 기본흐름 >> 1. 사용자시스템은공연시설별통계조회오퍼레이션을요청한다. 1.1 조회조건에해당하는자료가없을경우 ' 조회된내용이없습니다 ' 메시지를출력한다 조회조건을변경하여공연시설별통계조회오퍼레이션을요청한다 공연시설별통계조회오퍼레이션목록 일련번호오퍼레이션서비스 URI 오퍼레이션설명 1 GET /openapi/restful/ prfstsprfbyfct/ 공연시설별통계조회 공연시설별통계조회오퍼레이션명세 오퍼레이션명 ( 국문 ) 공연시설별통계조회 오퍼레이션정보 오퍼레이션명 ( 영문 ) /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

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

39 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 좌석수 prfprocnt 공연건수 20 1 prfdtcnt 공연횟수 totnmrs 총관객수 nmrsshr 점유율