One Click Multi DRMの概要

Prev Next

Classic/VPC環境で利用できます。

One Click Multi DRMは、動画コンテンツの違法コピーや流通を防止するため、動画を暗号化して保存・転送する NAVERクラウドプラットフォームのサービスです。主要なデジタル著作権管理(DRM)システムをすべてサポートしていて、デバイスやプラットフォームに関係なく動画コンテンツを安全に再生できます。さらに、暗号化/復号化キーの発行と管理も可能です。One Click Multi DRMサービスでは、サイト管理、ライセンス発行、DRMポリシー管理など、DRMに関するさまざまな機能を RESTful API形式で提供します。

One Click Multi DRMの共通設定

One Click Multi DRM APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://multi-drm.apigw.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • Unix Timestamp形式
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
Content-Type Required リクエストデータの形式
  • application/json
x-ncp-region_code Required リージョンコード
  • KR: 韓国 (有効値)
x-drm-token Conditional DRMトークン
  • ライセンスの発行に必要なデータを含むトークン
  • ライセンス発行やクライアント連携時、必ず入力

レスポンス

共通レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

error

errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
error Object - エラーコードとメッセージ
error.code String Required エラーコード
error.name String Required エラー名
error.message String Required エラーメッセージ

レスポンスステータスコード

One Click Multi DRM APIで共通して使用されるレスポンスステータスコードの詳細は、次をご参照ください。

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

{
    "success": false,
    "error": {
        "code": 280000,
        "name": "EXCEPTION",
        "message": "Exception occurred, please try again later."
    }
}

One Click Multi DRM API

One Click Multi DRMサービスが提供する APIの説明は次の通りです。

Encryption

Encryption関連 APIの説明は次の通りです。

API 説明
DRMコンテンツ暗号化 コンテンツを DRM暗号化

Site

Site関連 APIの説明は次の通りです。

API 説明
サイトの作成 One Click Multi DRMサイトを作成
サイトログの照会 One Click Multi DRMサイトで発生したイベントログを照会
サイトリストの照会 One Click Multi DRMサイトリストを照会
サイトの照会 One Click Multi DRMサイトの詳細情報を照会
サイトの更新 One Click Multi DRMサイト情報を更新
サイトの無効化 One Click Multi DRMサイトを無効化
サイトの有効化 One Click Multi DRMサイトを有効化

License

License関連 APIの説明は次の通りです。

API 説明
ライセンスの発行(FairPlay) FairPlay Streamingタイプのライセンスを発行
ライセンスの発行(Widevine、PlayReady) Widevine、PlayReadyタイプのライセンスを発行
ライセンス発行履歴の照会 サイトで発行したライセンス履歴を照会
ライセンスクライアント連携 クライアント(プレイヤー)にライセンスを連携

DRM Policy

DRM Policy関連 APIの説明は次の通りです。

API 説明
ポリシーの作成 DRMポリシーを作成
ポリシーのコピー 既存の DRMポリシーをコピーして新しいポリシーを作成
ポリシーログの照会 DRMポリシーで発生したイベントログを照会
ポリシーリストの照会 DRMポリシーリストを照会
ポリシーの照会 DRMポリシーの詳細情報を照会
ポリシーの更新 DRMポリシー情報を更新
ポリシーの削除 DRMポリシーを削除

One Click Multi DRM関連リソース

One Click Multi DRM APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。