スケジュールの作成
- 印刷する
- PDF
スケジュールの作成
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Live Stationの VODスケジュールを作成する APIです。作成したスケジュール情報照会のためのスケジュール情報照会 APIを提供します。
参考
- スケジュールの作成により、Object Storageにアップロードされた動画(mp4)を決められた時間(startTime)に合わせてライブで配信できます。
- 最大50個の動画再生をサポートし、詳細は下記をご参照ください。
注意
VODスケジュール作成時の注意事項は、次の通りです。
- スケジュールの作成は、VODチャンネルの状態が READYの時に可能です。
- チャンネルに既にスケジュールが予約されている場合、追加スケジュールを作成することはできません。
- 予約されたスケジュールの配信が終了したり、配信待機中のスケジュールを削除した後に再度スケジュールを登録できます。
- スケジュールの開始時間(startTime)は KST(UTC+9)基準でリクエストします。
リクエスト
POST https://livestation.apigw.ntruss.com/api/v2/vod/schedule
リクエストヘッダ
| ヘッダ名 | 必須有無 | 説明 |
|---|---|---|
| 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) |
リクエストボディ
| フィールド名 | 必須有無 | タイプ | 制限事項 | 説明 |
|---|---|---|---|---|
| channelId | Yes | String | スケジュールを配信する VOD Channelの channelId | スケジュールを実行するチャンネルとして、既にスケジュールが登録されているチャンネルは使用不可 |
| startTime | Yes | Integer | リクエスト時間より過去の時間は入力不可 最小入力時間: 現在のリクエスト時点 + 10分以降の時間 最大入力時間: 現在のリクエスト時点 + 14日 | 入力した VODの配信開始時間 開始時間フォーマット: yyyyMMddHHmmss KST(UTC+9)基準 |
| vodList | Yes | Array | mp4拡張子のみ対応可能 最大50個の動画を入力可能 | |
| vodList.bucketName | Yes | String | 配信する動画が保存されている Object Storageのバケット名 | |
| vodList.filePath | Yes | String | 配信する動画が保存されている Object Storageの filePath filePathは「/」から始めること |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| scheduleId | Integer | ||
| channelId | String | ||
| createdTime | Timestamp | String | epoch time |
| startTime | Timestamp | epoch time | |
| updatedTime | Timestamp | ||
| status | String | CREATING,PROCESSING,PROCESSING_FAIL,UPDATING,READY,FINISH,DELETED | |
| vodList | Array |
例
リクエスト例
POST /api/v2/vod/schedule
HOST: livestation.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
{
"channelId": "ls-20211122220557-mUv3r",
"startTime": "20211124002500",
"vodList": [
{
"bucketName": "myBucket",
"filePath": "/myFile.mp4"
},
{
"bucketName": "myBucket2",
"filePath": "/mp4/myFile2.mp4"
},
{
"bucketName": "myBucket2",
"filePath": "/mp4/myFile3.mp4"
}
]
}
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
{
"content": {
"scheduleId": 10053,
"channelId": "ls-20211122220557-mUv3r",
"createdTime": 1637679144884,
"startTime": 1637681100000,
"updatedTime": 1637679144884,
"status": "CREATING",
"vodList": [
"/myBucket/myFile.mp4",
"/myBucket2/mp4/myFile2.mp4",
"/myBucket2/mp4/myFile3.mp4"
]
}
}
この記事は役に立ちましたか?