License 발급 이력 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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

이 문서가 도움이 되었습니까?

What's Next

Policy 생성

요청
응답
예시