Site の作成

サイト作成時の注意事項は、次のとおりです。

サイト作成には、作成日を基準に最大24時間かかる場合があります。サイト作成後にライセンス発行が可能です。
サイト作成完了後、サイトを有効化状態にしてからライセンス発行が可能です。
One Click Multi DRMは、Naver Cloud Live Station商品と簡単な連携をサポートします。連携ガイドの詳細は、Live Station DRM適用ガイドをご参照ください。

リクエスト

POST https://multi-drm.apigw.ntruss.com/api/v1/sites

リクエストヘッダ

ヘッダ名	要否	説明
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)

ヘッダ名

要否

説明

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)

リクエストボディ

フィールド名	要否	タイプ	制約事項	説明
siteName	Yes	String	最小3文字以上、最大20文字まで入力可能特殊文字の(-)を許可	作成するサイト名
policyId	Yes	Integer	default policyId : 0	DRM適用時に活用する drm type別 playback、security policy
fairPlayCert	Optional	Object		FairPlay Streaming DRM適用のための fairplay certitication
fairPlayCert.certFile	Optional	String	.der or .cerファイルのみサポート	Appleから取得した FairPlay Streaming証明書 http download urlのみサポートする
fairPlayCert.privateKey	Optional	String	*.pemファイルのみサポート	Appleから取得した FairPlay Streaming証明書のプライベートキーファイル http download urlのみサポートする
fairPlayCert.privateEncryptedString	Optional	String		FairPlay Streaming証明書発行時に取得したプライベートキー(private key)
fairPlayCert.secretKey	Optional	String		FairPlay Streaming証明書発行時に取得した Application secret key(ASK)文字列

フィールド名

要否

タイプ

制約事項

説明

siteName

Yes

String

最小3文字以上、最大20文字まで入力可能
特殊文字の(-)を許可

作成するサイト名

policyId

Yes

Integer

default policyId : 0

DRM適用時に活用する drm type別 playback、security policy

fairPlayCert

Optional

Object

FairPlay Streaming DRM適用のための fairplay certitication

fairPlayCert.certFile

Optional

String

*.der or *.cerファイルのみサポート

Appleから取得した FairPlay Streaming証明書
http download urlのみサポートする

fairPlayCert.privateKey

Optional

String

*.pemファイルのみサポート

Appleから取得した FairPlay Streaming証明書のプライベートキーファイル
http download urlのみサポートする

fairPlayCert.privateEncryptedString

Optional

String

FairPlay Streaming証明書発行時に取得したプライベートキー(private key)

fairPlayCert.secretKey

Optional

String

FairPlay Streaming証明書発行時に取得した Application secret key(ASK)文字列

レスポンス

フィールド名	要否	タイプ	制約	説明
siteName	Yes	String	最小3文字以上、最大20文字まで入力可能特殊文字の(-)を許可	作成するサイト名
siteId	Yes	String		作成したサイトの固有 ID
siteStatus	Yes	String	CREATING,READY,RUNNING,DELETED	作成したサイトの状態
siteEnabledYn	Yes	Boolean		サイト有効化の有無
policyId	Yes	Integer	default policyId : 0	DRM適用時に活用する drm type別 playback、security policy
fairPlayCert	Optional	Object		FairPlay Streaming DRM適用のための fairplay certitication
fairPlayCert.certFile	Optional	String	.der or .cerファイルのみサポート	Appleから取得した FairPlay Streaming証明書 http download urlのみサポートする
fairPlayCert.privateKey	Optional	String	*.pemファイルのみサポート	Appleから取得した FairPlay Streaming証明書のプライベートキーファイル http download urlのみサポートする
fairPlayCert.privateEncryptedString	Optional	String		FairPlay Streaming証明書発行時に取得したプライベートキー(private key)
fairPlayCert.secretKey	Optional	String		FairPlay Streaming証明書発行時に取得した Application secret key(ASK)文字列
siteCreatedTime	Yes	Timestamp		サイト作成時刻
siteUpdatedTime	Yes	Timestamp		サイトがアップデートされた時刻

フィールド名

要否

タイプ

制約

説明

siteName

Yes

String

最小3文字以上、最大20文字まで入力可能
特殊文字の(-)を許可

作成するサイト名

siteId

Yes

String

作成したサイトの固有 ID

siteStatus

Yes

String

CREATING,READY,RUNNING,DELETED

作成したサイトの状態

siteEnabledYn

Yes

Boolean

サイト有効化の有無

policyId

Yes

Integer

default policyId : 0

DRM適用時に活用する drm type別 playback、security policy

fairPlayCert

Optional

Object

FairPlay Streaming DRM適用のための fairplay certitication

fairPlayCert.certFile

Optional

String

*.der or *.cerファイルのみサポート

Appleから取得した FairPlay Streaming証明書
http download urlのみサポートする

fairPlayCert.privateKey

Optional

String

*.pemファイルのみサポート

Appleから取得した FairPlay Streaming証明書のプライベートキーファイル
http download urlのみサポートする

fairPlayCert.privateEncryptedString

Optional

String

FairPlay Streaming証明書発行時に取得したプライベートキー(private key)

fairPlayCert.secretKey

Optional

String

FairPlay Streaming証明書発行時に取得した Application secret key(ASK)文字列

siteCreatedTime

Yes

Timestamp

サイト作成時刻

siteUpdatedTime

Yes

Timestamp

サイトがアップデートされた時刻

例

リクエスト例

POST /api/v1/sites HOST: multi-drm.apigw.ntruss.com Content-Type: application/json x-ncp-apigw-timestamp:1521787414578 x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M= x-ncp-region_code:KR Request body (if fairplayCert is ready) { "fairPlayCert": { "certFile": "https://kr.object.ncloudstorage.com/myBucket/myFairPlayCert.cer", "privateEncryptedString": "myFairPlayCertEncryptedString", "privateKey": "https://kr.object.ncloudstorage.com/myBucket/myFairPlayCertPrivateKey.der", "secretKey": "myFairPlayCertSecretKey" }, "policyId": 0, "siteName": "myDrmSite" } Request body (if fairplayCert is not ready) { "policyId": 0, "siteName": "myDrmSite" }

レスポンス例

HTTP/1.1 200 OK Server: nginx Date: Fri, 22 Nov 2023 09: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": { "siteId": "drm-20231122192776-MJTKM", "siteName": "myFirstDrmSite", "siteStatus": "CREATING", "siteEnabledYn": false, "policyId": 0, "fairPlayCert": {}, "statistics": {}, "siteCreatedTime": 1700648847450, "siteUpdatedTime": 1700648847450 } }

Site の作成

リクエスト

リクエストヘッダ

リクエストボディ

レスポンス

例

リクエスト例

レスポンス例

What's Next