MENU
      View license issuance history
        • PDF

        View license issuance history

        • PDF

        Article summary

        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}
        HTTP

        Request parameters

        Field nameRequirement statusTypeRestrictionDescription
        pageNoNoIntegerNo restrictionPage index to view
        pageSizeNoNoInteger1-100Number 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
        siteIdYesString
        searchConditionNoStringcontentId, drmType, userId, deviceId, deviceModel
        searchKeywordNoString
        startTimeNoTimestampeg: 1699605801000
        endTimeNoTimestampeg: 1700469801000
        statusNoStringsuccess, failIssue successful/failure status condition

        Request headers

        Header nameRequirement statusDescription
        x-ncp-apigw-timestampYESThis 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-keyYESValue of access key ID issued in the NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecifies the request body content type as application/json
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Response

        Field nameRequirement statusTypeRestrictionDescription
        contentIdYesStringUnique ID of content played through the issued license
        Value used for DRM packaging
        licenseStatusYesStringSUCCESS,FAILIssue successful/failure status condition
        drmTypeYesStringWidevine
        PlayReady
        FairPlay
        DRM type that requests license
        userIdYesStringUnique 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.
        deviceIdYesStringDevice ID that requested the DRM license
        deviceModelYesStringDevice model that requested the DRM license
        platformNameYesStringName of platform that requested the DRM license
        licenseCreatedTimeYesTimestampLicense issuance time

        Examples

        Request example

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

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

        Was this article helpful?

        What's Next
        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.