スケジュール作成
- 印刷する
- PDF
スケジュール作成
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Live StationのVODスケジュールを作成するAPIです。作成したスケジュール情報を照会するためのスケジュール情報照会APIを提供します。
VODスケジュール
- スケジュール作成を通じて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を配信する開始時間 開始時間フォーマット：yyyymmddhhss 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"
]
}
}
この記事は役に立ちましたか?