View license issuance history

Prev Next

One Click Multi DRM provides an API to view the history of the license issued from the created site.

Requests 

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

Request parameters

Field name Requirement status Type Restriction Description
pageNo No Integer No restriction Page index to view
pageSizeNo No Integer 1-100 Number of license issuance cases to be included when viewing lists
For example, when 60 license issuance cases are created with pageSizeNo 30, the viewing of license issuance history list is done in 30 cases per page
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 Issue successful/failure status condition

Request headers

Header name Requirement status Description
x-ncp-apigw-timestamp YES This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 (UTC)
If the time difference compared to the API Gateway server is 5 minutes or longer, then the request is considered invalid
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key YES Value of access key ID issued in the NAVER Cloud Platform portal
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 YES Signature encrypted with the access key ID value and secret key
x-ncp-apigw-signature-v2:{API Gateway Signature}
Content-Type YES Specifies the request body content type as application/json
Content-Type: application/json
x-ncp-region_code YES Region code (KR)

Response

Field name Requirement status Type Restriction Description
contentId Yes String Unique ID of content played through the issued license
Value used for DRM packaging
licenseStatus Yes String SUCCESS,FAIL Issue successful/failure status condition
drmType Yes String Widevine
PlayReady
FairPlay		 DRM type that requests license
userId Yes String Unique user ID of the user that requested the license (user ID managed by the service site or user account playing the DRM content)
userID is displayed as a md5 hash value.
deviceId Yes String Device ID that requested the DRM license
deviceModel Yes String Device model that requested the DRM license
platformName Yes String Name of platform that requested the DRM license
licenseCreatedTime Yes Timestamp License issuance time

Examples

Request example

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

Response example

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"
    },
    ...
  }