Home
지원센터 이용안내
응용 프로그램 인터페이스
음악이용로그조회 응용 프로그램 인터페이스
소개
저작권위원회 통합전산망 시스템에 수집되는 음악로그 정보를 일단위로 수신하는 응용 프로그램 인터페이스
(위원회와 별도 협약 필요, OSP승인 시 제공가능, UCI정보 필수 , 저작물신고 응용 프로그램 인터페이스 신청 전제 )
요청 Base URL
https://Openapi.findcopyright.or.kr/api/broker-musiclog
요청 파라미터 설명
음악이용로그조회 응용 프로그램 인터페이스 요청 파라미터 설명
구분 |
파라미터 |
데이터타입 |
필수구분 |
설명 |
샘플데이터 |
header |
clientId |
String |
O |
비즈니스지원센터와 협의된 고객 id |
12345 |
apiKey |
String |
O |
비즈니스지원센터와 협의된, 본 인터페이스 유효키 apiKey |
9f72bdae-3d88-46e6-940e-xxxxxxxxxxxx |
apiDiv |
String |
O |
응용 프로그램 인터페이스 구분ID (관리저작물보고_음악1) |
2 |
parameter |
pageNo |
Number |
|
페이지번호(기본값 : 1) |
1 |
numOfRows |
Number |
|
한 페이지 결과 수(기본값 : 10) |
10 |
searchStartDt |
String |
O |
YYYYMMDD 형식 |
20220706 |
searchEndDt |
String |
|
YYYYMMDD 형식(기본값 : 서비스 시작일자) |
20220706 |
사용예제
응답 결과
음악이용로그조회 응용 프로그램 인터페이스 응답 결과
영역 |
파라미터 |
데이터타입 |
필수구분 |
설명 |
샘플데이터 |
json |
resultCode |
String |
O |
결과코드 |
200 |
resultMsg |
String |
O |
결과메세지 |
요청에 대한 작업을 정상적으로 완료하였습니다. |
pageNo |
String |
O |
페이지번호 |
1 |
numOfRows |
String |
O |
한페이지 결과수 |
10 |
totalCount |
String |
O |
전체 결과수 |
300 |
mum |
String |
O |
ROW번호, 화면 사용시 필요하면 사용 |
1 |
serviceDay |
String |
O |
서비스되어 로그생성된 날짜 |
20220728 |
ospSysNm |
String |
O |
OSP코드 |
DREAMUS |
ospSysCd |
String |
O |
OSP코드 |
DREAMUS |
ospSysNm |
String |
O |
OSP명 |
드림어스 |
brokerCd |
String |
O |
대리중개업체코드 |
|
brokerNm |
String |
O |
대리중개업체명 |
루미넌트 |
serviceCode |
String |
O |
서비스코드 |
AC30 |
serviceNm |
String |
O |
서비스명 |
2018_마케팅_싱글_종량500ST_MV |
ospSongId |
String |
|
OSP곡코드 |
35524 |
isrc |
String |
|
ISRC |
KRA341205652 |
uci |
String |
O |
서비스 음원 UCI |
uci:i500-AE13105119.1200975191-1 |
useCnt |
String |
O |
서비스된 기간 SUM횟수 |
505 |
stopRson |
String |
|
중지사유가 있을시 중지 상태이며 이용횟수가 0으로 전송됨 |
곡 권리 문제로 중지 |