License 発行履歴の照会
- 印刷する
- PDF
License 発行履歴の照会
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
One Click Multi DRMは、作成したサイトで発行したライセンス履歴を照会するための APIを提供します。
リクエスト
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}
リクエストパラメータ
| フィールド名 | 要否 | タイプ | 制約 | 説明 |
|---|---|---|---|---|
| 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 | NAVERクラウドプラットフォームポータルで発行した 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.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"
},
...
}
この記事は役に立ちましたか?