License 발급 이력 조회

Prev Next

One Click Multi DRM 은 생성된 사이트에서 발급된 라이선스 이력을 조회하기 위한 API를 제공합니다.

요청 

GET https://multi-drm.apigw.gov-ntruss.com/api/v1/license/statistics?pageNo={pageNo}&pageSizeNo={pageSizeNo}&siteId={siteId}&searchCondition={searchCondition}&searchKeyword={searchKeyword}&startTime={startTime}&status={status}

요청 파라미터

필드명 필수 여부 타입 제약 설명
pageNo No Integer 제약 없음 조회할 페이지 인덱스
pageSizeNo No Integer 1~100 목록 조회 시 포함될 라이선스 발급 이력 수
예시) 생성된 라이선스 발급 이력이 60개일 때, pageSizeNo 30 이라면 페이지당 30개씩 라이선스 발급 이력 목록 조회
siteId Yes String
searchCondition No String contentId, drmType, userId, deviceId, deviceModel
searchKeyword No String
startTime No Timestamp eg: 1699605801000
endTime No Timestamp eg: 1700469801000
status No String success, fail 라이선스 발급 성공/실패 상태 조건

요청 헤더

헤더명 필수 여부 설명
x-ncp-apigw-timestamp YES 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄
API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key YES 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 YES Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature}
Content-Type YES Request body content type을 application/json으로 지정
Content-Type: application/json
x-ncp-region_code YES 리전 코드 (KR)

응답

필드명 필수 여부 타입 제약 설명
contentId Yes String 발행된 라이선스를 통해 재생된 콘텐츠의 고유 ID
DRM 패키징 시 사용된 값
licenseStatus Yes String SUCCESS,FAIL 라이선스 발급 성공/실패 상태 조건
drmType Yes String Widevine
PlayReady
FairPlay		 라이선스를 요청하는 DRM 타입
userId Yes String 라이선스를 요청한 사용자의 고유 ID (서비스 사이트에서 관리하는 유저 ID 혹은 DRM 컨텐츠를 재생한 사용자 계정)
userId 는 md5 hash 값으로 노출 됩니다.
deviceId Yes String DRM 라이선스를 요청한 디바이스 ID
deviceModel Yes String DRM 라이선스를 요청한 디바이스 모델
platformName Yes String DRM 라이선스를 요청한 플랫폼명
licenseCreatedTime Yes Timestamp 라이선스 발급 시각

예시

요청 예시

https://multi-drm.apigw.gov-ntruss.com/api/v1/license/statistics?searchCondition=drm_type&searchKeyword=Widevine&siteId=drm-20231115142326-nHyNw

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Thu, 23 Nov 2023 18:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
 {
  "success": true,
  "content": [
    {
      "contentId": "myFirst-Drm-cnt",
      "licenseStatus": "success",
      "drmType": "Widevine",
      "userId": "d41d8cd98f00b204e9800998ecf8427e",
      "deviceId": "23abfd802575758cb3bfdc147e819fc6",
      "deviceModel": "ChromeCDM-Mac-ARM64-9",
      "platformName": "PLATFORM_MAC_OS",
      "licenseCreatedTime": "20231120095732"
    },
    {
      "contentId": "myFirst-Drm-cnt",
      "licenseStatus": "success",
      "drmType": "Widevine",
      "userId": "d41d8cd98f00b204e9800998ecf8427e",
      "deviceId": "23abfd802575758cb3bfdc147e819fc6",
      "deviceModel": "ChromeCDM-Mac-ARM64-9",
      "platformName": "PLATFORM_MAC_OS",
      "licenseCreatedTime": "20231120085658"
    },
    {
      "contentId": "myFirst-Drm-cnt",
      "licenseStatus": "success",
      "drmType": "Widevine",
      "userId": "d41d8cd98f00b204e9800998ecf8427e",
      "deviceId": "23abfd802575758cb3bfdc147e819fc6",
      "deviceModel": "ChromeCDM-Mac-ARM64-9",
      "platformName": "PLATFORM_MAC_OS",
      "licenseCreatedTime": "20231120085658"
    },
    {
      "contentId": "myFirst-Drm-cnt",
       "licenseStatus": "success",
      "drmType": "Widevine",
      "userId": "d41d8cd98f00b204e9800998ecf8427e",
      "deviceId": "23abfd802575758cb3bfdc147e819fc6",
      "deviceModel": "ChromeCDM-Mac-ARM64-9",
      "platformName": "PLATFORM_MAC_OS",
      "licenseCreatedTime": "20231120085625"
    },
    {
      "contentId": "myFirst-Drm-cnt",
      "licenseStatus": "success",
      "drmType": "Widevine",
      "userId": "d41d8cd98f00b204e9800998ecf8427e",
      "deviceId": "23abfd802575758cb3bfdc147e819fc6",
      "deviceModel": "ChromeCDM-Mac-ARM64-9",
      "platformName": "PLATFORM_MAC_OS",
      "licenseCreatedTime": "20231120085603"
    },
    ...
  }