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	네이버 클라우드 플랫폼 포털에서 발급받은 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

네이버 클라우드 플랫폼 포털에서 발급받은 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