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}
    

    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
    

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

    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.